Rate Limit Response Header

All calls within the Web API are allotted a specific number of requests per refresh period.

Each Web API request returns the following header information regarding rate limits and number of requests left.

Depending on the endpoint you are trying to reach, it will have a specific number of allowed requests per refresh period. Once this threshold has been reached, we will return a status code 429 response.

Example Request

1
GET https://api.sendgrid.com/v3/resource HTTP/1.1

Example Response

1
2
3
4
5
6
7
8
9
HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 500
X-RateLimit-Remaining: 499
X-RateLimit-Reset: 1392815263

{
  "foo": "bar"
}

When Limit is Reached

You will no longer be able to make requests against that endpoint for the duration of that refresh period.

Example Request

1
GET https://api.sendgrid.com/v3/resource/ HTTP/1.1

Example Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
HTTP/1.1 429 TOO MANY REQUESTS
Content-Type: application/json
X-RateLimit-Limit: 150
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1392815263

{
  "errors": [
    {
      "field": null,
       "message": "too many requests"
    },
  ]
}