Retrieve Subuser Reputations
For more information about Subusers, visit the longform Subusers documentation. You can also manage Subusers in the SendGrid console.
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.
Property nameTypeRequiredDescription
Authorizationstring
required
Default:
Bearer <<YOUR_API_KEY_HERE>>
Property nameTypeRequiredDescription
usernamesstring
Optional
200
SchemaExample
Array of:
Property nameTypeRequiredDescriptionChild properties
reputationnumber
Optional
The sender reputation this subuser has attained.
usernamestring
Optional
The subuser that has this reputation.
1const client = require("@sendgrid/client");2client.setApiKey(process.env.SENDGRID_API_KEY);34const request = {5url: `/v3/subusers/reputations`,6method: "GET",7};89client10.request(request)11.then(([response, body]) => {12console.log(response.statusCode);13console.log(response.body);14})15.catch((error) => {16console.error(error);17});