Response Codes

This is the list of all HTTP response status codes returned by ConvertAPI. Each response carries a standard HTTP status code; the response body may add a numeric sub-code with more detail about the result. An example response body of an authentication failure:

Response Header

HTTP status code 401

Response body

{
    "Code": 4013,
    "Message": "Missing credentials. Please provide a valid API token."
}

HTTP status codes

Status code	Meaning
200 OK	Conversion completed successfully.
400 Bad Request	Request does not provide all data to execute the conversion.
401 Unauthorized	Invalid or missing API credentials.
403 Forbidden	No conversions remaining. Upgrade your plan or purchase more conversions.
415 Unsupported Media Type	The file is not supported by file server or endpoint.
500 Internal Server Error	Conversion failure.
503 Service Unavailable	Request rejected due to rate limits. Retry is available after a few seconds (see Throttle and Fallback).

400 Bad Request sub-codes

Sub-code	Meaning
4000	Parameter validation error.
4001	No content disposition provided.
4002	Bad JSON format.
4005	File encoded in Base64 not found.

500 Internal Server Error sub-codes

Sub-code	Meaning
5000	Conversion timeout.
5001	Conversion failed.
5002	File is damaged.
5003	File is password protected.
5004	No tables to extract in PDF file.
5005	Can not delete all document pages. The document should contain at least one page.
5006	The current encryption algorithm does not support Unicode passwords.
5007	Cannot decrypt PDF.
5008	Unable to access the file.
5009	File id is invalid.
50010	File link is set incorrectly. Url or File Id must be set.
50013	Images were not found in the PDF file.
50020	There are no supported files available for extraction.
50050	Unexpected exception. We have been notified about the problem and will try to fix it asap.