Skip to content Skip to navigation Skip to topbar

Retrieve Subuser Reputations

API Overview

For more information about Subusers, visit the longform Subusers documentation. You can also manage Subusers in the SendGrid console.

Operation overview

GET/v3/subusers/reputations

Base url: https://api.sendgrid.com

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

Authentication

API Key

Headers

Property nameTypeRequiredDescription

Authorizationstringrequired

Default: Bearer <<YOUR_API_KEY_HERE>>

Query string

Property nameTypeRequiredDescription

usernamesstringOptional

Responses

200

SchemaExample

Array of:

Property nameTypeRequiredDescriptionChild properties

reputationnumber

The sender reputation this subuser has attained.

usernamestring

The subuser that has this reputation.

Retrieve Subuser Reputations

Node.js

Python

Java

PHP

Ruby

curl


_18const client = require('@sendgrid/client');
_18client.setApiKey(process.env.SENDGRID_API_KEY);
_18
_18
_18const request = {
_18  url: `/v3/subusers/reputations`,
_18  method: 'GET',
_18  
_18}
_18
_18client.request(request)
_18  .then(([response, body]) => {
_18    console.log(response.statusCode);
_18    console.log(response.body);
_18  })
_18  .catch(error => {
_18    console.error(error);
_18  });