How to use the SendGrid V3 API
Welcome to SendGrid’s Web API v3! This API is RESTful, fully featured, easy to integrate with, and offers support in 7 different languages.
Libraries
Rate Limits
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
HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 500
X-RateLimit-Remaining: 499
X-RateLimit-Reset: 1392815263
{
"foo": "bar"
}
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
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"
},
]
}
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.