On this page

Rate Limits

API Overview

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

Libraries

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

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

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

When You Reach a Rate Limit

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

Example

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

1HTTP/1.1 429 TOO MANY REQUESTS
2Content-Type: application/json
3X-RateLimit-Limit: 150
4X-RateLimit-Remaining: 0
5X-RateLimit-Reset: 1392815263
6
7{
8  "errors": [
9    {
10      "field": null,
11       "message": "too many requests"
12    },
13  ]
14}