Skip to contentSkip to navigationSkip to topbar
Twilio SendGrid Docs
On this page

Rate Limits

API Overview

api-overview page anchor

Welcome to SendGrid's Web API v3! This API is RESTful and offers support in seven different languages.

Libraries

libraries page anchor

Rate Limit Response Header

rate-limit-response-header page anchor

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

example page anchor
GET https://api.sendgrid.com/v3/resource HTTP/1.1
1
HTTP/1.1 200 OK

2
Content-Type: application/json

3
X-RateLimit-Limit: 500

4
X-RateLimit-Remaining: 499

5
X-RateLimit-Reset: 1392815263

6


7
{

8
  "foo": "bar"

9
}

When You Reach a Rate Limit

when-you-reach-a-rate-limit page anchor

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

Example

example-2 page anchor
GET https://api.sendgrid.com/v3/resource/ HTTP/1.1
1
HTTP/1.1 429 TOO MANY REQUESTS

2
Content-Type: application/json

3
X-RateLimit-Limit: 150

4
X-RateLimit-Remaining: 0

5
X-RateLimit-Reset: 1392815263

6


7
{

8
  "errors": [

9
    {

10
      "field": null,

11
       "message": "too many requests"

12
    },

13
  ]

14
}