Error Codes
This page documents all possible API response codes and error types.Response Format
Success Response
When a request is successful, the API returns a response withcode: 200:
Error Response
When an error occurs, the API returns a response with the corresponding error code:Task Failed Response
When a task fails during processing, the response includesstatus: "failed" with an error message:
Business Status Codes
200 - Success
Request completed successfully. Check thestatus field in the response to determine task state.
400 - Bad Request
The request contains invalid parameters or data.
Example:
402 - Payment Required
Insufficient account balance or credits.
Example:
403 - Forbidden
Access denied due to permission restrictions.
Example:
404 - Not Found
The requested resource does not exist.
Example:
408 - Request Timeout
The request took too long to process.
Example:
429 - Too Many Requests
Rate limit exceeded.
Example:
500 - Internal Server Error
An unexpected server error occurred.
Example:
502 - Bad Gateway
Upstream service error.
Example:
503 - Service Unavailable
The service is temporarily unavailable.
Example: