HTTP Status Codes

The Ocrolus API leverages a specific set of HTTP status codes to indicate the success or failure of an incoming request.

All requests that are successfully sent to our API return the HTTP status code 200 OK.

To diagnose requests that are experiencing server issues (a rare occurrence), use the following HTTP status codes:

HTTP status codeCause
502 Bad GatewayThe Ocrolus public proxy is experiencing issues.
503 Service UnavailableThe service is down for maintenance.
504 Gateway TimeoutThe service did not respond within a reasonable time.
429 Too Many RequestsYou've made too many API requests recently. Our API rate limit is five requests per second.
413 Payload Too LargeYou're attempting to upload a file that's too large. See here for more information about what you can do.

If processing a request generates an application error, the JSON response includes the error. For more information, see Ocrolus Status Codes.

📘

If at first you don't succeed...

We suggest that your application retries requests that fail for reasons beyond its control, such as server or network issues. Every API has the occasional misstep, including Ocrolus; planning accordingly can make your product more resilient against unexpected errors.

If there's a problem with our API, we'll report it on our status page.