Welcome to SendGrid's Web API v3! This API is RESTful and offers support in seven different languages.
All responses are returned in JSON format. We specify this by sending the Content-Type header.
GET https://api.sendgrid.com/v3/resource HTTP/1.1
1HTTP/1.1 200 OK2Content-Type: application/json34{5"foo": "bar"6}
Below is a table containing descriptions of the various status codes we currently support against various resources.
| Status Code | Description |
|---|---|
| 200 | No error |
| 201 | Successfully created |
| 204 | Successfully deleted |
| 400 | Bad request |
| 401 | Requires authentication |
| 403 | From address doesn't match Verified Sender Identity. To learn how to resolve this error, see our Sender Identity requirements. |
| 403 | You are temporarily blocked from sending emails due to repeated bad requests. |
| 406 | Missing Accept header. For example: Accept: application/json |
| 429 | Too many requests/Rate limit exceeded |
| 500 | Internal server error |
When a request is made with a pagination query, the following data is included in the header to allow for traversal of previous, current, first, and last page of the data set.
GET https://api.sendgrid.com/v3/resource?limit=5&offset=0 HTTP/1.1
1HTTP/1.1 200 OK2Content-Type: application/json34Link: <http://api.sendgrid.com/v3/resource?limit=5&offset=5>; rel="next"; title="2",5<http://api.sendgrid.com/v3/resource?limit=5&offset=0>; rel="prev"; title="1",6<http://api.sendgrid.com/v3/resource?limit=5&offset=10>; rel="last"; title="3",7<http://api.sendgrid.com/v3/resource?limit=5&offset=0>; rel="first"; title="1"8