Query PDF

The file parameter allows you to select a local file to be uploaded to pdfRest’s processing server.

The id parameter allows you to submit a resource ID generated by one of our API Tools. Each of our API Tools assigns a unique resource ID to your output file(s), allowing you to chain requests together without having to download intermediate files between requests.

For example, you can submit the output ID you receive from our Merge PDFs tool to reduce the file size of your new PDF before you download it.

• tagged
  • Checks for presence of structure tags in the input document.
  • Returns true or false
• image_only
  • Checks if the document is 'image only' meaning that it will only feature a series of embedded graphical image files, one per page and does not have any text or other features common to PDF documents, except for some metadata.
  • Returns true or false
• title
  • The title of the PDF as listed in the metadata.
  • Returns a string which may be empty if the document does not have a title
• subject
  • The subject of the PDF as listed in the metadata.
  • Returns a string which may be empty if the document does not have a subject
• author
  • The author of the PDF as listed in the metadata.
  • Returns a string which may be empty if the document does not have an author
• producer
  • The producer of the PDF as listed in the metadata.
  • Returns a string which may be empty if the document does not have a producer
• creator
  • The creator of the PDF as listed in the metadata.
  • Returns a string which may be empty if the document does not have a creator
• creation_date
  • The creation date of the PDF as listed in the metadata.
  • Returns a string which may be empty if the document does not have a creation date
• modified_date
  • The most recent modification date of the PDF as listed in the metadata.
  • Returns a string which may be empty if the document does not have a modification date
• keywords
  • The keywords of the PDF as listed in the metadata.
  • Returns a string which may be empty if the document does not have keywords
• doc_language
  • The language that the file claims to be written in.
  • Returns a string
• page_count
  • The number of pages in the PDF document.
  • Returns an integer
• contains_annotations
  • Checks whether the document contains annotations, such as notes, highlighted text, file attachments, crossed out text, and text callout boxes.
  • Returns true or false
• contains_signature
  • Checks if the document contains any digital signatures.
  • Returns true or false
• pdf_version
  • Retrieves the version of the PDF standard that the document was created with.
  • Returns a string of the form X.Y.Z where X, Y, and Z are the major, minor, and extension versions respectively
• file_size
  • Retrieves the size of the input file in bytes.
  • Returns an integer
• filename
  • The name of the input file.
  • Returns a string
• restrict_permissions_set
  • Checks whether the document has restrict permissions set to prevent printing, copying, signing etc.
  • Returns true or false
• contains_xfa
  • Checks whether the document contains XFA forms.
  • Returns true or false
• contains_acroforms
  • Checks whether the document contains Acroforms.
  • Returns true or false
• contains_javascript
  • Checks whether the document contains javascript.
  • Returns true or false
• contains_transparency
  • Checks whether the document contains transparent objects.
  • Returns true or false
• contains_embedded_file
  • Checks whether the document contains one or more embedded files.
  • Returns true or false
• uses_embedded_fonts
  • Checks whether the document contains fully embedded fonts.
  • Returns true or false
• uses_nonembedded_fonts
  • Checks whether the document contains non-embedded fonts.
  • Returns true or false
• pdfa
  • Checks whether the document claims and conforms to a PDF/A standard.
  • Returns true or false
• requires_password_to_open
  • Checks whether the document requires a password to open.
  • Returns true or false.
  • Note: A document requiring a password cannot be opened by this route and will not be able to return much other information