Welcome to SendGrid's Web API v3! This API is RESTful and offers support in seven different languages.
Sometimes your API call will generate an error. Here you will find additional information about what to expect if you don't format your request properly, or we fail to properly process your request.
Status Code | Description |
---|---|
400 | Bad request |
401 | Requires authentication |
403 | Too many bad requests. Temporary block |
406 | Missing Accept header. For example: Accept: application/json |
429 | Too many requests/Rate limit exceeded |
500 | Internal server error |
The general format guidelines are displayed when the accompanying status code is returned.
GET https://api.sendgrid.com/v3/resource HTTP/1.1
1HTTP/1.1 400 BAD REQUEST2Content-Type: application/json34{5"errors": [6{"field": "identifier1", "message": "error message explained"},7{"field": "identifier2", "message": "error message explained"},8{"field": "identifier3", "message": "error message explained"},9]10}