View the ParseX API error response format, HTTP status codes, error messages, and their meanings.
When a request fails, the API returns a request ID, an error code, and an error message.
Return to the API overview to review the async calling flow.
Error response structure
| Field | Type | Description |
|---|---|---|
request_id | string | The request ID, which can be used to locate the failed request. |
code | string | The error code. |
message | string | The error message. |
Error
Common error codes
| code | HTTP | message | Description |
|---|---|---|---|
NotExistBizId | 400 | The bizId not exist. | The biz ID does not exist |
ResultNotReady | 409 | Retrieve result if job is not completed. | The task is not complete; the result is not ready yet |
Parameter errors
| code | HTTP | message | Description |
|---|---|---|---|
FileDownloadFailed | 400 | File download failed. | File download failed; not retryable |
FileDownloadTimeout | 400 | File download timed out. | File download timed out; retryable |
FileFormatNotSupported | 400 | Unsupported file formats | Unsupported file format |
FileSizeExceeded | 400 | File size exceeds limit | File size exceeds the limit |
InvalidFileUrl | 400 | URL is invalid or inaccessible | The URL is invalid or inaccessible |
ParseResultExpired | 400 | The ParseResult has exceeded the 30-day retention period. | The parsing result has expired; it is beyond the 30-day retention period |
PageCountExceeded | 400 | The page count exceeds the limit. | The page count exceeds the limit |
PageRangeInvalid | 400 | The page range is invalid. | The page range is invalid |
Task errors
| code | HTTP | message | Description |
|---|---|---|---|
ProcessingFailed | 500 | An internal error occurred in the processing engine. | Internal error in the processing engine |
ProcessingTimeout | 500 | The processing timed out. | Processing timed out |
BatchProcessingFailed | 500 | The batch processing failed. | Batch processing failed |
CustomerOssWriteFailed | 500 | Failed to write to the customer OSS. | Failed to write to the customer OSS |
InternalError | 500 | An internal error has occurred, please try again later. | Internal error |
Extraction errors
| code | HTTP | message | Description |
|---|---|---|---|
ParseResultNotReusable | 400 | The ParseResult is not reusable because the input is audio/video or the type does not match. | The parsing result is not reusable |
UnsupportedFileType | 400 | Extract does not support audio/video input. | Extract does not support audio/video input |
InvalidSchema | 400 | The schema format is invalid. | The schema format is invalid |
Other errors
| code | HTTP | message | Description |
|---|---|---|---|
AccountOverdue | 403 | Service suspended due to unpaid fees | Service suspended due to overdue payment |
ServiceQuotaExhausted | 503 | The service quota is exhausted. | Service quota exhausted |
Handling suggestions
Task result not ready
Task result not ready
When you receive
ResultNotReady, the task has not completed yet. Continue calling the corresponding result endpoint with the original biz_id.File download failed
File download failed
FileDownloadFailed is marked as non-retryable; fix the file URL or access conditions first. FileDownloadTimeout is marked as retryable.Extraction task cannot reuse the parsing result
Extraction task cannot reuse the parsing result
Check whether the parsing result is still within the 7-day retention period, and whether the input is audio/video or a mismatched type that Extract does not support.