Response Codes#

The full set of response codes from the PDF.co API are as follows:

Code

Description

200

Success.

204

No content. The server successfully processed the request, and is not returning any content.

400

Bad request. Typically happens because of bad input parameters, or because the input URLs can’t be reached, possibly due to access restrictions like needing a login or password.

401

Unauthorized. Authentication is required and has failed or has not yet been provided.

402

Not enough credits.

403

Access forbidden for input URL.

404

The requested resource could not be found.

408

The server timed out waiting for the request.

414

The URI provided was too long for the server to process.

415

The request entity has a media type which the server or resource does not support.

429

The user has sent too many requests in a given amount of time (see: rate limiting).

441

Invalid Password. Password protected document.

442

Input document is damaged or of incorrect type.

443

Permissions. The operation is prohibited by document security settings. You can turn off this check by setting the profiles param to {CheckPermissions: false}. Important: only use this if you are the owner of the document or have legal permission to turn off permissions. PDF.co is not liable for any legal repercussions caused by ignoring permissions.

444

Profiles parsing error. Please make sure that the configuration is supported. Explore profiles samples at /profiles.

445

Timeout error. To process large documents or files please use asynchronous mode (set the async parameter to true) and then check status using the /job/check endpoint. If a file contains many pages then specify a page range using the pages parameter. The number of pages of the document can be obtained using the /pdf/info endpoint.

446

Some files required for conversion are missing.

447

Invalid template.

448

Invalid URL or HTML. Make sure that provided URL is valid and accessible.

449

Invalid index range. Page index is out of range. Get page count via /pdf/info endpoint. First page is 0.

450

Invalid page range specified.

452

Invalid URL.

454

Invalid parameters.

455

Failed to send email.

456

Invalid color. Should be a valid color. For example: "Red" , "Green" or Html HexString like "#CCBBAA" or without ‘#’ symbol as "CCBBAA".

457

SMTP server blocked.

466

Invalid base64 image.

490

Incorrect result data.

500

Something went wrong. Please try again or contact customer support.

501

Not implemented. The server was acting as a gateway or proxy and received an invalid response from the upstream server.

502

Bad gateway. The server was acting as a gateway or proxy and received an invalid response from the upstream server.

503

Service unavailable. The server cannot handle the request because it is overloaded or down for maintenance.

504

Gateway timeout. The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.

505

HTTP version not supported. The server does not support the HTTP version used in the request.