Skip to contentSkip to navigationSkip to topbar
Twilio SendGrid Docs
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).

Operation overview

operation-overview page anchor

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.

Operation details

operation-details page anchor

Authentication

authentication page anchor

Headers

headers page anchor
Property nameTypeRequiredDescription
Authorizationstringrequired
Default: Bearer <<YOUR_API_KEY_HERE>>

Query string

query-string page anchor
Property nameTypeRequiredDescription
usernamesstringOptional

Responses

responses page anchor
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


5
const request = {

6
  url: `/v3/subusers/reputations`,

7
  method: 'GET',

8
  

9
}

10


11
client.request(request)

12
  .then(([response, body]) => {

13
    console.log(response.statusCode);

14
    console.log(response.body);

15
  })

16
  .catch(error => {

17
    console.error(error);

18
  });