Error Codes
Standard HTTP error codes and internal application codes returned by the API.
All errors return a standard JSON format to help you handle them programmatically.
Error Response Format
{"error": "Unsupported chain ID","code": "UNSUPPORTED_CHAIN","details": { "chainId": 9999 }}
Common HTTP Statuses
| Status | Meaning | Recommended Action |
|---|---|---|
| 400 | Bad Request. Invalid parameters or input format. | Check your payload (txHash, chainId). |
| 401 | Unauthorized. Missing or invalid API Key. | Verify x-api-key header. |
| 403 | Forbidden. Quota exceeded or restricted. | Check usage limits in dashboard. |
| 429 | Rate Limit Exceeded. | Implement exponential backoff. |
| 500 | Internal Server Error. | Retry later. Contact support if persistent. |
Application Error Codes
Detailed codes returned in the code field.
| Code | Description |
|---|---|
| INVALID_HASH | The transaction hash format is incorrect (e.g. invalid length). |
| UNSUPPORTED_CHAIN | The requested chain ID is not supported by our node providers. |
| QUOTA_EXCEEDED | You have exceeded your monthly generation quota. Upgrade plan. |
| JOB_TIMEOUT | The worker could not fetch data in time. Usually chain congestion. |
| SERVER_FAILURE | An unexpected error occurred during PDF generation. |