Errors
The API returns standard HTTP status codes and a JSON body with an error message when something goes wrong.
Status codes
400 Bad Request
Invalid request (e.g. missing file, invalid parameters). Check that you send multipart/form-data with a valid PDF file.
401 Unauthorized
Missing or invalid API key. Ensure you pass Authorization: Bearer YOUR_API_KEY in the request header.
402 Payment Required
Subscription or billing issue; tier limit exceeded. Upgrade your plan or wait until your next billing period. See Pricing.
413 Payload Too Large
File exceeds the max size for your tier. Free: 5 MB; Basic: 25 MB; Pro: 100 MB. See Rate Limits.
429 Too Many Requests
Rate limit exceeded; retry after a short delay. Implement exponential backoff. See Rate Limits.
500 Internal Server Error
Server error; retry or contact support.
Error response format
{
"error": "Human-readable error message"
}