Error Codes

Rekognita API uses standard HTTP response codes and adds detailed error codes for precise issue diagnosis.

HTTP Codes

Code	Name	Description
`200`	OK	Request successful
`201`	Created	Resource created
`400`	Bad Request	Invalid request format or parameters
`401`	Unauthorized	Invalid or missing API key
`403`	Forbidden	Key lacks permission for this operation
`404`	Not Found	Resource not found
`413`	Payload Too Large	File exceeds maximum size
`415`	Unsupported Media Type	File format not supported
`422`	Unprocessable Entity	Document cannot be processed
`429`	Too Many Requests	Rate limit exceeded
`500`	Internal Server Error	Error on Rekognita side
`503`	Service Unavailable	Service temporarily unavailable

Error Format

{
  "error": {
    "code": "invalid_file_type",
    "message": ".exe file format is not supported. Supported formats: pdf, docx, xlsx, jpg, png, tiff",
    "param": "file",
    "doc_url": "https://docs.rekognita.com/supported-files"
  }
}

Detailed Error Codes

Code	Description	Solution
`invalid_api_key`	Invalid API key	Check the key in the Dashboard
`expired_api_key`	Key deactivated	Create a new key
`invalid_file_type`	Unsupported format	See supported types
`file_too_large`	File too large	Reduce size or split
`page_limit_exceeded`	Too many pages	Process in chunks
`rate_limit_exceeded`	Rate limit exceeded	Wait for Retry-After
`processing_failed`	Processing failed	Try again or change model
`insufficient_credits`	Insufficient credits	Top up your balance
`schema_validation_failed`	Invalid JSON schema	Check schema format