On this page

Responses

API Overview

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

Libraries

Content-Type Header

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 OK
2Content-Type: application/json
3
4{
5  "foo": "bar"
6}

Status Codes

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

Pagination

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 OK
2Content-Type: application/json
3
4Link: <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