Welcome to SendGrid's Web API v3! This API is RESTful, fully featured, easy to integrate with, and offers support in 7 different languages.
All responses are returned in JSON format. We specify this by sending the Content-Type header.
_10GET https://api.sendgrid.com/v3/resource HTTP/1.1
_10HTTP/1.1 200 OK_10Content-Type: application/json_10_10{_10 "foo": "bar"_10}
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 easy traversal of previous, current, first, and last page of the data set.
_10GET https://api.sendgrid.com/v3/resource?limit=5&offset=0 HTTP/1.1
_10HTTP/1.1 200 OK_10Content-Type: application/json_10_10Link: <http://api.sendgrid.com/v3/resource?limit=5&offset=5>; rel="next"; title="2",_10 <http://api.sendgrid.com/v3/resource?limit=5&offset=0>; rel="prev"; title="1",_10 <http://api.sendgrid.com/v3/resource?limit=5&offset=10>; rel="last"; title="3",_10 <http://api.sendgrid.com/v3/resource?limit=5&offset=0>; rel="first"; title="1"