Skip to contentSkip to navigationSkip to topbar
On this page

Retrieve Subuser Reputations



API Overview

api-overview page anchor

For more information about Subusers, visit the longform Subusers documentation. You can also manage Subusers in the SendGrid console(link takes you to an external page).


GET/v3/subusers/reputations

Base url: https://api.sendgrid.com (for global users and subusers)

Base url: https://api.eu.sendgrid.com (for EU regional subusers)

This endpoint allows you to request the reputations for your subusers.

Subuser sender reputations give a good idea how well a sender is doing with regards to how recipients and recipient servers react to the mail that is being received. When a bounce, spam report, or other negative action happens on a sent email, it will affect your sender rating.


Authentication

authentication page anchor
Property nameTypeRequiredDescription
Authorizationstringrequired
Default: Bearer <<YOUR_API_KEY_HERE>>
Property nameTypeRequiredDescription
usernamesstringOptional
200
SchemaExample

Array of:

Property nameTypeRequiredDescriptionChild properties
reputationnumber

The sender reputation this subuser has attained.


usernamestring

The subuser that has this reputation.

Retrieve Subuser ReputationsLink to code sample: Retrieve Subuser Reputations
1
const client = require("@sendgrid/client");
2
client.setApiKey(process.env.SENDGRID_API_KEY);
3
4
const request = {
5
url: `/v3/subusers/reputations`,
6
method: "GET",
7
};
8
9
client
10
.request(request)
11
.then(([response, body]) => {
12
console.log(response.statusCode);
13
console.log(response.body);
14
})
15
.catch((error) => {
16
console.error(error);
17
});

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.