Response Codes

This is the list of all HTTP response status codes returned by ConvertAPI. The three-number code describes HTTP Status code and four number code shows additional information about the result in the response body. The example response body of authentication failure:

Response Header

HTTP status code 401

Response body

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

Result

• 200 OK Conversion completed successfully.

Malformed request

• 400 Bad Request Request does not provide all data to execute the conversion.
  • 4000 Parameter validation error.
  • 4001 No content disposition provided.
  • 4002 Bad JSON format.
  • 4005 File encoded in Base64 not found.

Authentication

• 401 Unauthorized Authentication failure.
  • 4010 Invalid user credentials. Please provide a valid secret.
  • 4011 Invalid user credentials. Please provide a valid token.
  • 4012 Invalid user credentials. Please provide a valid self generated token.
  • 4013 Missing credentials. Please provide a valid API token.
  • 4014 The conversion balance reached zero, and no more conversions can be done.
  • 4015 User inactive.

Not Supported

• 415 Unsupported Media Type The file is not supported by file server or endpoint.

Conversion failure

• 500 Internal Server Error Conversion failure.
  • 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.

Throttle failure

• 503 service unavailable Request rejected due to rate limits. Retry is available after a few seconds.