Errors

When a request to the Unblocked API fails, the response body is a JSON object with a status field containing the HTTP status code.

{
  "status": 401
}

Status codes

Status	Description
400	Bad request. The request body or parameters are invalid.
401	Unauthorized. The request is missing a valid API token, or the token is invalid or expired.
403	Forbidden. The API token doesn’t have permission to perform this action.
404	Not found. The requested resource doesn’t exist, or you don’t have access to it.
429	Too many requests. You’ve exceeded a rate limit. See Rate limits.
500	Internal server error. An unexpected error occurred on the server.
502	Bad gateway. The API couldn’t connect to an upstream service.
504	Gateway timeout. An upstream service didn’t respond in time.

Retrying failed requests

502 and 504 responses are transient. Retry the request with a short delay between attempts. A 500 response may also be transient, but retrying isn’t guaranteed to succeed. If it persists, contact us. For 429 responses, wait before retrying. See Rate limits for current limits.

Rate limits List Answers

⌘I

Overview

Answers

Collections

Documents

Status codes

Retrying failed requests

​Status codes

​Retrying failed requests

Status codes

Retrying failed requests