HTTP responses

The API uses HTTP responses to indicate success or error.

HTTP statusWhy
200 OK- Successful operations
400 Bad Request- Invalid JSON request
401 Unauthorized- Account does not have permission to perform the operation. - OAuth token is missing or invalid/expired.
403 Forbidden- Invalid input format - Missing body - Limits threshold reached
404 Not Found- Resource not found - Endpoint not found
406 Not Acceptable- No content-type specified - Content-Type not accepted
429 Too Many Requests- Rate limit exceeded
500 Server Error- Internal API error
502 Bad Gateway- Failure in our upstream providers
503 Service Unavailable- API is experiencing a downtime - API is under maintenance
504 Gateway Timeout- Timeout on operation

Did this page help you?
// Bulk plan CTA banner: requested by Alison to promote the high-volume pricing plan. Injected in Footer HTML per ReadMe convention, but renderd at the top of the viewport via the fixed-position CSS above.
Sending 250K+ links a year? You qualify for a better rate. See high-volume pricing