ParseX API error codes
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.
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. |
{
"request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"code": "NotExistBizId",
"message": "The bizId not exist."
}
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
When you receive ResultNotReady, the task has not completed yet. Continue calling the corresponding result endpoint with the original biz_id.
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
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.
Return to the API overview to review the async calling flow.