Menu

Retrieve a list of scopes for which this user has access.

Retrieve a list of scopes for which this user has access.

GET /scopes

This endpoint returns a list of all scopes that this user has access to.

API Keys are used to authenticate with SendGrid's v3 API.

API Keys may be assigned certain permissions, or scopes, that limit which API endpoints they are able to access.

This endpoint returns all the scopes assigned to the key you use to authenticate with it. To retrieve the scopes assigned to another key, you can pass an API key ID to the "Retrieve an existing API key" endpoint.

For a more detailed explanation of how you can use API Key permissions, please visit our API Keys documentation.

Authentication

  • API Key

Headers

Authorization
string
default: Bearer <<YOUR_API_KEY_HERE>>
required
on-behalf-of
string
default: The subuser's username. This header generates the API call as if the subuser account was making the call.

Responses

object
scopes
array[string]

The list of scopes for which this user has access.

uniqueItems: True
required
object
errors
array[object]

This 401 response indicates that the user making the call doesn't have the authorization to view the list of scopes.

required
field
null

This empty field is returned instead of the list of scopes if the user making the call doesn't have the authorization required.

message
string

Explains why the scopes cannot be returned.

object
errors
array[object]
message
string

the error message

field
string

the field that generated the error

help
object

helper text or docs for troubleshooting

id
string
{
  "errors": [
    {
      "field": "field_name",
      "message": "error message"
    }
  ]
}
object
errors
array[object]
message
string

the error message

field
string

the field that generated the error

help
object

helper text or docs for troubleshooting

id
string
{
  "errors": [
    {
      "field": "field_name",
      "message": "error message"
    }
  ]
}
object
errors
array[object]
message
string

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.