Passport Loader

PassportPDF REST API Reference

PassportPDF API (1.1.64)

Another brick in the cloud. | Download OpenAPI specification

Introduction

PassportPDF API is a REST API that lets you perform complex operations on documents and images easily. You may consume the API by using one of our many open source SDKS available in a variety of languages, or any REST client by sending your requests to the appropriate endpoints.

Only HTTPS requests are accepted, and supported TLS versions range from 1.0 to 1.3.

Authentication

After signing up on PassportPDF, you will be able to see and manage information about your passports. A passport contains a certain number of tokens, depending on the plan associated with it, which will be consumed as you make use of the API.

Each available operation has a base token cost, and a charge method which may vary depending on the type of service provided. You will find these information in the documentation of every operation listed on this page.

ApiKey

Your passport number acts as an API key and needs to be provided with every request.

Security Scheme Type: API Key
Header parameter name: X-PassportPDF-API-Key

Errors

PassportPDF API does not use specific HTTP codes to indicate when a request could not be fullfiled, but instead returns a normal 200 response contaning JSON serialized detailed information about the reason of the failure.

Every response returned by an operation contains an Error in its definition, and its presence in a response indicates that something went wrong. It is therefore crucial for a client to always check that a JSON response does not contain a serialized Error object before proceeding further.

Note that no token is charged by the API whenever an error occurs.

The Error model

Among the information given by the Error model, ResultCode specifies a value of the PassportPDFStatus enumeration, that defines a first level of error information. InternalErrorId defines a unique identifier for the error, which comes very handy for us to troubleshoot any issue you may encounter quickly.

ExtResultMessage
string or null

Specifies a message which further describes the error.

ExtResultStatus
string or null

Specifies a result code related to an error which occurred in an external component.

InternalErrorId
string or null

Specifies a unique identifier, allowing to easily assess the error.

ResultCode
string
Default: "OK"
Enum: "OK" "ActionTimedOut" "EmptyParameter" "InvalidAPIKey" "NotEnoughTokens" "GenericError" "InvalidParameter" "InvalidColor" "OutOfMemory" "NotImplemented" "FileNotFound" "AccessDenied" "CanNotImportFileToPDF" "PdfCanNotBeDecrypted" "PdfOperationNotAllowed" "PdfCanNotOpenFile" "PdfCanNotSaveFile" "CanNotCreateFile" "NoDocumentProvided" "CanNotRemovePage" "CanNotSwapPages" "CanNotMovePage" "CanNotRotatePage" "CanNotFlipPage" "InvalidPageRange" "CanNotReducePDF" "CanNotAutoDeskew" "CanNotSplit" "CanNotSaveAsJPEG" "CanNotDigiSign" "CanNotProtect" "CanNotConvertToPDFA" "CanNotAnnotate" "CanNotClearPage" "CanNotMerge" "CanNotGetPageThumbnail" "CanNotGetDocumentPreview" "CanNotRemovePageFormFields" "CanNotInsertImage" "CanNotDrawImage" "CanNotInsertPageNumber" "CanNotInsertText" "CanNotReadBarcode" "CanNotFlatten" "CanNotExportMoreThan2GigabyteFile" "CanNotOpenSession" "UnknownOrExpiredSession" "CanNotSaveFile" "CanNotRepairPDF" "UnsupportedImageFormat" "CanNotOCR" "CanNotOpenImage" "CanNotSaveAsPNG" "CanNotSaveAsTIFF" "CanNotSaveAsTIFFMultipage" "CanNotSetInfo" "CanNotSetPageBox" "CanNotExtractPage" "CanNotInsertNewPage" "CanNotClonePage" "CanNotSetInitialView" "CanNotAdjust" "CanNotResize" "CanNotFilter" "CanNotCleanupDocument" "UnknownDocumentFormat" "CanNotCrop" "CanNotRotate" "CanNotDetectColor" "CanNotConvertColorDepth" "PdfCanNotAddFont" "ActionExecutionRejected" "CanNotExtractText" "CanNotDetectBlankPages" "CanNotReadMICR" "CanNotDetectPageOrientation" "CanNotDeletePage" "CanNotSaveAsPDF" "CanNotExtractImage" "CanNotCloneImageRegion" "CanNotReorderPages" "CanNotAutoCrop" "CanNotScalePage" "CanNotMergePages" "CanNotGetMetaData" "CanNotSetMetadata" "CanNotRemoveText" "CanNotDownloadDocument" "CanNotRedact" "CanNotValidatePDFA" "CanNotConvertToGrayscale" "CanNotSaveAsJPEG2000" "HTTPTransferError" "CanNotReadMRZ" "CanNotAnalyzeDocument" "CanNotSmartRedact" "CanNotOpenDocument" "CanNotQueryDocument" "CanNotSaveAsDOCX" "CanNotSaveAsXLSX" "CanNotSaveAsPPTX"

Specifies a PassportPDF status.

{
  • "ResultCode": "OK",
  • "ExtResultStatus": "string",
  • "ExtResultMessage": "string",
  • "InternalErrorId": "string"
}

Efficiency considerations

Multipart upload/download is available and lets you directly stream a file to/from the API. For example, in the PDF APIs, LoadDocument/LoadDocumentMultipart and SaveDocument/SaveDocumentToFile may be used to upload/download a document using respectively binary data serialization and streaming multipart HTTP requests.

The second approach should be favored when dealing with large files, as it will be much more efficient in that context.

Config

All the configuration-related APIs.

ConfigGetAPIVersion

Gets the current version of the API.
No token is charged for this operation.

Responses

Response Schema:
string

Response samples

Content type
No sample

ConfigGetMaxAllowedContentLength

Gets the maximal length of a request content, in bytes.
No token is charged for this operation.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Value
integer <int64>

The response value.

Response samples

Content type
No sample

ConfigGetSuggestedClientTimeout

Gets the suggested client API timeout, in milliseconds.
No token is charged for this operation.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Value
integer <int32>

The response value.

Response samples

Content type
No sample

ConfigGetSuggestedMaxClientThreads

Gets the suggested maximum number of threads to be used simultaneously by a client application.
No token is charged for this operation.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Value
integer <int32>

The response value.

Response samples

Content type
No sample

ConfigGetSupportedFonts

Gets the list of supported fonts for text drawing operations.
No token is charged for this operation.

Responses

Response Schema:
Array
FamilyName
string or null

Specifies the family name of the font, i.e: "Arial".

FontStyle
string
Default: "Regular"
Enum: "Regular" "Bold" "Italic" "BoldItalic"

Defines the different available font styles.

Response samples

Content type
No sample

ConfigGetSupportedOCRLanguages

Gets the list of supported languages for OCR.
No token is charged for this operation.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Value
Array of strings or null

The response value.

Response samples

Content type
No sample

DocumentAI

All the document AI-related APIs. (Preview)

AnalyzeDocument

Performs AI analysis on any kind of document, of any format, from any source. The response provides extraction of structured data such as key-value pairs and tables as well as complete OCR.
20 tokens are charged per page.
Request Body schema:

An AnalyzeDocumentParameters object specifying the parameters of the action.

FileContent
string or null <byte>

If non empty, specifies the content of the file to be processed.

FileId
string or null

If non empty, specifies the identifier of the previously uploaded file to be processed.

Language
string or null
Default: "eng"

Specifies the language to be used for the OCR. Supported values are:

  • "deu" for German.
  • "eng" for English.
  • "fra" for French.
  • "ita" for Italian.
  • "por" for Portuguese.
  • "spa" for Spanish.
  • "jpn" for Japanese.
MeasurementUnit
string
Default: "Pixel"
Enum: "Pixel" "Points" "Inches" "Centimeters"

Specifies the unit of measure for a given data type.

PageRange
string or null
Default: "*"

Specifies the page or the page range to be processed.

Uri
string or null

If non empty, specifies the uri of the file to be processed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (DocumentPage)

Specifies a list of page results.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

SpreadsheetMLData
string or null <byte>

Specifies an Open XML SpreadsheetML file containing all extracted tables of the document.

Request samples

Content type
{ }

Response samples

Content type
No sample

QueryDocument

- This is a preview action - Produces an answer to an arbitrary text question related to a document, of any format, which can be provided from any source. The response provides the answer to the question.
20 tokens are charged per request.
Request Body schema:

An QueryDocumentParameters object specifying the parameters of the action.

Queries
required
Array of strings

Specifies the plain text queries.

SecretKEY
required
string non-empty

Specifies the Open AI API Key.

FileContent
string or null <byte>

If non empty, specifies the content of the file to be processed.

FileId
string or null

If non empty, specifies the identifier of the previously uploaded file to be processed.

PageRange
string or null
Default: "*"

Specifies the page or the page range to be processed.

PreserveParagraphs
boolean
Default: false

Specifies if the text extraction engine shall format text retaining paragraphs integrity.

Uri
string or null

If non empty, specifies the uri of the file to be processed.

Responses

Response Schema:
Answers
Array of strings or null

Specifies the answers to the queries.

object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "Queries": [
    ],
  • "SecretKEY": "string"
}

Response samples

Content type
No sample

SmartRedaction

Performs smart redaction on any kind of document, of any format, from any source. The response provides detected marks and optionally the redacted document, as PDF format.
20 tokens are charged per page.
Request Body schema:

An SmartRedactionParameters object specifying the parameters of the action.

Color
string or null
Default: "black"

Specifies the color for the resulting region color, using the color name (ie: "black") or its RGBa code (ie: "rgba(255,0,0,1)").

FileContent
string or null <byte>

If non empty, specifies the content of the file to be processed.

FileId
string or null

If non empty, specifies the identifier of the previously uploaded file to be processed.

Immediate
boolean
Default: true

Specifies whether the redaction marks must be immediately. If set to false, only detected redaction marks will be produced in the response.

Language
string or null
Default: "eng"

Specifies the language to be used for the OCR. Supported values are:

  • "deu" for German.
  • "eng" for English.
  • "fra" for French.
  • "ita" for Italian.
  • "por" for Portuguese.
  • "spa" for Spanish.
  • "jpn" for Japanese.
PageRange
string or null
Default: "*"

Specifies the page or the page range to be processed.

RedactCreditCardNumbers
boolean
Default: false

Specifies whether the engine must redact credit card numbers.

RedactEmailAddresses
boolean
Default: false

Specifies whether the engine must redact email addresses.

RedactIBANs
boolean
Default: false

Specifies whether the engine must redact IBANs.

RedactIPAddresses
boolean
Default: false

Specifies whether the engine must redact IP addresses.

RedactPhoneNumbers
boolean
Default: false

Specifies whether the engine must redact phone numbers.

RedactPostalAddresses
boolean
Default: false

Specifies whether the engine must redact postal addresses.

RedactSocialSecurityNumbers
boolean
Default: false

Specifies whether the engine must redact social security numbers.

RedactURIs
boolean
Default: false

Specifies whether the engine must redact URIs.

RedactVatIDs
boolean
Default: false

Specifies whether the engine must redact VAT identifiers.

RedactVehicleIdentificationNumbers
boolean
Default: false

Specifies whether the engine must redact vehicle identification numbers.

Uri
string or null

If non empty, specifies the uri of the file to be processed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

FileContent
string or null <byte>

Specifies the produced file content.

Array of objects or null (RedactionMark)

Specifies a list of identified redaction marks.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{ }

Response samples

Content type
No sample

Document

All the document-related APIs.

DocumentClose

Closes a previously uploaded document.
No token is charged for this operation.
Request Body schema:

A DocumentCloseParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

DocumentGetPreview

Gets the format, the page count and a thumbnail of a previously uploaded document.
1 token is charged per request.
Request Body schema:

A GetDocumentPreviewParameters object specifying the parameters of the action.

FileId
required
string non-empty

Specifies the identifier of the file to be previewed.

ThumbnailBackgroundColor
string or null
Default: "rgba(0,0,0,0)"

Specifies the background color of the thumbnail, using the color name (ie: "red") or its RGBa code (ie: "rgba(255,0,0,1)").

ThumbnailFitToPageSize
boolean
Default: true

Specifies if the size of the produced thumbnail is automatically adjusted to don't have any margin.

ThumbnailHeight
integer <int32>
Default: 220

Specifies, in pixels, the height of the thumbnail to be retrieved.

ThumbnailWidth
integer <int32>
Default: 140

Specifies, in pixels, the width of the thumbnail to be retrieved.

Responses

Response Schema:
DocumentFormat
string
Default: "UNKNOWN"
Enum: "UNKNOWN" "ICO" "BMP" "WBMP" "JPEG" "GIF" "PNG" "TIFF" "FAXG3" "EXIF" "EMF" "WMF" "JNG" "KOALA" "IFF" "MNG" "PCD" "PCX" "PBM" "PBMRAW" "PFM" "PGM" "PGMRAW" "PPM" "PPMRAW" "RAS" "TARGA" "PSD" "CUT" "XBM" "XPM" "DDS" "HDR" "SGI" "EXR" "J2K" "JP2" "PICT" "RAW" "WEBP" "DICOM" "JBIG" "JBIG2" "WSQ" "PDF" "SVG" "TXT" "DOCX" "RTF" "DXF" "ODT" "XLSX" "PPTX" "DOC" "XLS" "PPT" "HTML" "HEIF" "MSG" "EML" "PostScript"

Specifies the format of a document.

object (Error)

Contains all the information related to an error which has occurred.

PageCount
integer <int32>

Specifies the page count of the document.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

ThumbnailData
string or null <byte>

Specifies the data of a thumbnail from the first page of the document, in PNG format.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

DocumentLoad

Loads the provided document file.
1 token is charged per 10 MB of the input file size.
Request Body schema:

A LoadDocumentFromByteArrayParameters object specifying the parameters of the action.

Content
required
string <byte>

Specifies the data of the document.

ContentEncoding
string
Default: "Identity"
Enum: "Identity" "Gzip"

Indicates the encoding mode of data.

FileName
string or null

Specifies the name of the document.

GetPreview
boolean
Default: false

Specifies whether the response must contain a thumbnail of the first page of the document.

ThumbnailBackgroundColor
string or null
Default: "rgba(0,0,0,0)"

Specifies the background color of the thumbnail, using the color name (ie: "red") or its RGBa code (ie: "rgba(255,0,0,1)"). Only applicable if GetPreview has been set to true.

ThumbnailFitToPageSize
boolean
Default: true

Specifies if the size of the produced thumbnail is automatically adjusted to don't have any margin. Only applicable if GetPreview has been set to true.

ThumbnailHeight
integer <int32>
Default: 220

Specifies, in pixels, the height of the thumbnail to be retrieved. Only applicable if GetPreview has been set to true.

ThumbnailWidth
integer <int32>
Default: 140

Specifies, in pixels, the width of the thumbnail to be retrieved. Only applicable if GetPreview has been set to true.

Responses

Response Schema:
DocumentFormat
string
Default: "UNKNOWN"
Enum: "UNKNOWN" "ICO" "BMP" "WBMP" "JPEG" "GIF" "PNG" "TIFF" "FAXG3" "EXIF" "EMF" "WMF" "JNG" "KOALA" "IFF" "MNG" "PCD" "PCX" "PBM" "PBMRAW" "PFM" "PGM" "PGMRAW" "PPM" "PPMRAW" "RAS" "TARGA" "PSD" "CUT" "XBM" "XPM" "DDS" "HDR" "SGI" "EXR" "J2K" "JP2" "PICT" "RAW" "WEBP" "DICOM" "JBIG" "JBIG2" "WSQ" "PDF" "SVG" "TXT" "DOCX" "RTF" "DXF" "ODT" "XLSX" "PPTX" "DOC" "XLS" "PPT" "HTML" "HEIF" "MSG" "EML" "PostScript"

Specifies the format of a document.

object (Error)

Contains all the information related to an error which has occurred.

FileId
string or null

Specifies the file identifier of the loaded document.

PageCount
integer <int32>

Specifies the number of pages into the loaded document.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

ThumbnailData
string or null <byte>

Specifies the data of a thumbnail from the first page of the document, in PNG format. Only applicable if the GetPreview field of the request has been set to true.

Request samples

Content type
{
  • "Content": "string"
}

Response samples

Content type
No sample

DocumentLoadFromURI

Loads the provided document file from an URI.
1 token is charged per 10 MB of the input file size.
Request Body schema:

A LoadDocumentFromURIParameters object specifying the parameters of the action.

URI
required
string non-empty

Specifies the uri of the document.

ContentEncoding
string
Default: "Identity"
Enum: "Identity" "Gzip"

Indicates the encoding mode of data.

FileName
string or null

Specifies the name of the document.

GetPreview
boolean
Default: false

Specifies whether the response must contain a thumbnail of the first page of the document.

ThumbnailBackgroundColor
string or null
Default: "rgba(0,0,0,0)"

Specifies the background color of the thumbnail, using the color name (ie: "red") or its RGBa code (ie: "rgba(255,0,0,1)"). Only applicable if GetPreview has been set to true.

ThumbnailFitToPageSize
boolean
Default: true

Specifies if the size of the produced thumbnail is automatically adjusted to don't have any margin. Only applicable if GetPreview has been set to true.

ThumbnailHeight
integer <int32>
Default: 220

Specifies, in pixels, the height of the thumbnail to be retrieved. Only applicable if GetPreview has been set to true.

ThumbnailWidth
integer <int32>
Default: 140

Specifies, in pixels, the width of the thumbnail to be retrieved. Only applicable if GetPreview has been set to true.

Responses

Response Schema:
DocumentFormat
string
Default: "UNKNOWN"
Enum: "UNKNOWN" "ICO" "BMP" "WBMP" "JPEG" "GIF" "PNG" "TIFF" "FAXG3" "EXIF" "EMF" "WMF" "JNG" "KOALA" "IFF" "MNG" "PCD" "PCX" "PBM" "PBMRAW" "PFM" "PGM" "PGMRAW" "PPM" "PPMRAW" "RAS" "TARGA" "PSD" "CUT" "XBM" "XPM" "DDS" "HDR" "SGI" "EXR" "J2K" "JP2" "PICT" "RAW" "WEBP" "DICOM" "JBIG" "JBIG2" "WSQ" "PDF" "SVG" "TXT" "DOCX" "RTF" "DXF" "ODT" "XLSX" "PPTX" "DOC" "XLS" "PPT" "HTML" "HEIF" "MSG" "EML" "PostScript"

Specifies the format of a document.

object (Error)

Contains all the information related to an error which has occurred.

FileId
string or null

Specifies the file identifier of the loaded document.

PageCount
integer <int32>

Specifies the number of pages into the loaded document.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

ThumbnailData
string or null <byte>

Specifies the data of a thumbnail from the first page of the document, in PNG format. Only applicable if the GetPreview field of the request has been set to true.

Request samples

Content type
{
  • "URI": "string"
}

Response samples

Content type
No sample

DocumentLoadMultipart

Loads the provided document file using Multipart Upload.
1 token is charged per 10 MB of the input file size.
Request Body schema: multipart/form-data
fileData
required
string <binary>
object (LoadDocumentParameters)

Represents the parameters for importing a document.

Responses

Response Schema:
DocumentFormat
string
Default: "UNKNOWN"
Enum: "UNKNOWN" "ICO" "BMP" "WBMP" "JPEG" "GIF" "PNG" "TIFF" "FAXG3" "EXIF" "EMF" "WMF" "JNG" "KOALA" "IFF" "MNG" "PCD" "PCX" "PBM" "PBMRAW" "PFM" "PGM" "PGMRAW" "PPM" "PPMRAW" "RAS" "TARGA" "PSD" "CUT" "XBM" "XPM" "DDS" "HDR" "SGI" "EXR" "J2K" "JP2" "PICT" "RAW" "WEBP" "DICOM" "JBIG" "JBIG2" "WSQ" "PDF" "SVG" "TXT" "DOCX" "RTF" "DXF" "ODT" "XLSX" "PPTX" "DOC" "XLS" "PPT" "HTML" "HEIF" "MSG" "EML" "PostScript"

Specifies the format of a document.

object (Error)

Contains all the information related to an error which has occurred.

FileId
string or null

Specifies the file identifier of the loaded document.

PageCount
integer <int32>

Specifies the number of pages into the loaded document.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

ThumbnailData
string or null <byte>

Specifies the data of a thumbnail from the first page of the document, in PNG format. Only applicable if the GetPreview field of the request has been set to true.

Response samples

Content type
No sample

DocuVieware

All the DocuVieware-related APIs. DocuViewere also includes a JavaScript client API fully documented here: https://www.docuvieware.com/guides/aspnet/JavaScript%20API%20Overview.html

DocuViewareGetControl

Gets the HTML dom of a DocuVieware control.
3 tokens are charged for each document loaded through the delivered DocuVieware control, as well as 1 token per 10 MB of their total size.
Request Body schema:

A DocuViewareGetControlParameters object specifying the parameters of the action.

required
object (DocuViewareControlState)

Specifies configuration and appearance state of a DocuVieware control.

SessionID
required
string non-empty

Specifies the unique identifier used to identify the user session.

Responses

Response Schema:
Element
string or null

The element content, as HTML format.

object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "SessionID": "string",
  • "ControlState": { }
}

Response samples

Content type
No sample

DocuViewareGetVersion

Get the DocuVieware engine version.
No token is charged for this operation.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Value
string or null

The response value.

Response samples

Content type
No sample

DocuViewareSave

Saves the document being handled by a specific DocuVieware control, in its current state.
1 token is charged per request.
Request Body schema:

A DocuViewareSaveParameters object specifying the parameters of the action.

ControlId
required
string non-empty

Specifies the identifier associated with the control.

FileName
required
string non-empty

Specifies the name of the file to create.

Format
required
string non-empty

Specifies the format of the document to save. Supported values are tiff, pdf, pdf/a, pdf/a1a, pdf/a1b, pdf/a2a, pdf/a2b, pdf/a2u, pdf/a3a, pdf/a3b, pdf/a3u.

SessionId
required
string non-empty

Specifies the unique identifier used to identify the user session.

ApplyViewRotation
boolean
Default: false

Specifies whether page rotation(s) applied during the viewing cycle must be applied to the produced document as well.

DropAnnotations
boolean
Default: false

Specifies whether annotations must be removed from the produced document.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved into the new file.

Responses

Response Schema:
Content
string or null <byte>

Specifies the data of the produced file.

ContentType
string or null

Specifies content type of the produced data.

object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "SessionId": "string",
  • "ControlId": "string",
  • "FileName": "string",
  • "Format": "string"
}

Response samples

Content type
No sample

Image

All the image-related APIs. You can use ImageGetSupportedFileExtensions to obtain all the file extensions which can be loaded through these APIs.

ImageAdjust

Adjusts a previously uploaded image.
1 token is charged per page.
Request Body schema:

An ImageAdjustParameters object specifying the parameters for the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to adjust.

AutoContrastEnhancement
boolean
Default: false

Specifies whether the contrast shall be automatically enhanced.

Brightness
integer <int32>
Default: 0

Specifies the brightness parameter. The parameter has to be in the range [-100..100].

Contrast
integer <int32>
Default: 0

Specifies the contrast parameter. The parameter has to be in the range [-100..100].

ContrastHistogramStretch
boolean
Default: false

Specifies whether a contrast histogram stretch filter shall be performed.

GammaCorrection
integer <int32>
Default: 0

Specifies the gamma correction parameter. The parameter has to be in the range [-100..100].

RoiHeight
integer <int32>
Default: 0

Specifies the height, in pixel, of the region to process. 0 causes the entire image to be processed.

RoiLeft
integer <int32>
Default: 0

Specifies the left coordinate, in pixel, of the region to process.

RoiTop
integer <int32>
Default: 0

Specifies the top coordinate, in pixel, of the region to process.

RoiWidth
integer <int32>
Default: 0

Specifies the width, in pixel, of the region to process. 0 causes the entire image to be processed.

Saturation
integer <int32>
Default: 0

Specifies the saturation parameter. The parameter has to be in the range [-100..100].

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ImageAutoCrop

Automatically crops a previously uploaded image.
2 tokens are charged per page.
Request Body schema:

An ImageAutoCropParameters object specifying the parameters for the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to crop.

Confidence
number <float>
Default: 92

Specifies the confidence threshold in percentage.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ImageCleanupDocument

Cleanup a previously uploaded image.
1 token is charged per page.
Request Body schema:

An ImageCleanupDocumentParameters object specifying the parameters for the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to cleanup.

Deskew
boolean
Default: false

Specifies whether the document shall be deskewed.

DespeckleStrength
integer <int32>
Default: 0

Specifies the strength of the despeckle filter to be applied on the image. The value has to be in the range [0..100]. 0 disables the despeckle. The greater the strength, the more pixels will be removed from the image.

RemoveBlackBorders
boolean
Default: false

Specifies whether the dark borders of the document image shall be replaced with white content.

RemoveBottomMarginPunchHoles
boolean
Default: false

Specifies whether punch holes shall be removed from the bottom margin of the document.

RemoveLeftMarginPunchHoles
boolean
Default: false

Specifies whether punch holes shall be removed from the left margin of the document.

RemoveRightMarginPunchHoles
boolean
Default: false

Specifies whether punch holes shall be removed from the right margin of the document.

RemoveTopMarginPunchHoles
boolean
Default: false

Specifies whether punch holes shall be removed from the top margin of the document.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ImageCloneRegions

Clones regions from a previously uploaded image into new images.
1 token is charged per page.
Request Body schema:

An ImageCloneRegionsParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

required
Array of objects (ImageRegion)

The regions to be cloned.

Responses

Response Schema:
Array of objects or null (ClonedImageRegion)

The images created as a result of the action.

object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "ImageRegions": [
    ]
}

Response samples

Content type
No sample

ImageClose

Closes a previously uploaded image.
No token is charged for this operation.
Request Body schema:

An ImageCloseParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageConvertColorDepth

Converts the color depth of a previously uploaded image.
1 token is charged per page.
Request Body schema:

An ImageConvertColorDepthParameters object specifying the parameters for the action.

ConvertColorDepthMode
required
string
Default: "Depth1Bpp"
Enum: "Depth1Bpp" "Depth1BppOtsu" "Depth1BppBradley" "Depth1BppSauvola" "Depth1BppFast" "Depth4Bpp16" "Depth4BppQ" "Depth8BppGrayScale" "Depth8BppGrayScaleAdv" "Depth8Bpp216" "Depth8BppQ" "Depth16BppRGB555" "Depth16BppRGB565" "Depth24BppRGB" "Depth32BppARGB" "Depth32BppRGB" "Depth32BppPARGB" "Depth48BppRGB" "Depth64BppARGB" "Depth64BppPARGB"

Specifies the modes when changing the color depth of an image.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to process.

Depth1BppBradleyThreshold
integer <int32>
Default: 38

Specifies the threshold for a conversion using the Depth1BppBradley method. The value must be in the range [0..254] (suggested is 38). The higher the value, the whiter the resulting bitmap.

Depth1BppOtsuThreshold
integer <int32>
Default: 50

Specifies the threshold for a conversion using the Depth1BppOtsu method. The value must be in the range [0..100] (suggested is 50). The higher the value, the whiter the resulting bitmap.

Depth1BppSauvolaFactor
number <float>
Default: 0.35

Specifies the factor for a conversion using the Depth1BppSauvola method. The value must be in the range ]0..1[ (suggested is 0.35). The higher the value, the lighter the resulting bitmap.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string",
  • "ConvertColorDepthMode": "Depth1Bpp"
}

Response samples

Content type
No sample

ImageCrop

Crops a previously uploaded image.
2 tokens are charged per page.
Request Body schema:

An ImageCropParameters object specifying the parameters for the action.

CropBoxHeight
required
integer <int32>

Specifies the crop box height.

CropBoxLeft
required
integer <int32>

Specifies the crop box left coordinate.

CropBoxTop
required
integer <int32>

Specifies the crop box top coordinate.

CropBoxWidth
required
integer <int32>

Specifies the crop box width.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to crop.

CropUnit
string
Default: "Pixel"
Enum: "Pixel" "Percent"

Specifies the unit in which a crop box is expressed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string",
  • "CropBoxLeft": 0,
  • "CropBoxTop": 0,
  • "CropBoxWidth": 0,
  • "CropBoxHeight": 0
}

Response samples

Content type
No sample

ImageDeletePage

Deletes a page range from a previously uploaded image.
1 token is charged per request.
Request Body schema:

An ImageDeletePageParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded image to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to be deleted.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ImageDetectBlankPages

Detects the blank page(s) from a previously uploaded image and offers to remove them.
1 token is charged per page.
Request Body schema:

An ImageDetectBlankPagesParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of page to be processed.

RemoveDetectedBlankPages
boolean
Default: true

Specifies whether the detected blank page(s) shall be removed.

Responses

Response Schema:
DetectedBlankPages
Array of integers or null <int32>

Specifies the number of the pages which have been detected to be blank.

object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ImageDetectColor

Performs color detection on a previously uploaded image.
2 tokens are charged per page.
Request Body schema:

An ImageDetectColorParameters object specifying the parameters for the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to perform color detection on.

AutoConvert
boolean
Default: false

Specifies whether to automatically convert the image in its best suited/optimized bits-per-pixel encoding.

AutoRepairCharacters
boolean
Default: false

Specifies whether the characters shall be repaired during bitonal conversion, if any, or not. This feature is suggested for scanned gray papers acquired in color.

Responses

Response Schema:
Array of objects or null (ColorDetectionResult)

Specifies the result of the color detection operation performed on each page.

object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ImageDetectPageOrientation

Detects the orientation of the page(s) of a previously uploaded image and offers to automatically rotate them.
1 token is charged per page.
Request Body schema:

An ImagedetectPageOrientationParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to be processed.

AutomaticallyApplyRotation
boolean
Default: true

Specifies whether a rotation shall be automatically applied in order to correct the page orientation when needed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageOrientationInfo)

Holds information about the detected page orientations.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ImageFilter

Applies filters to a previously uploaded image.
1 token is charged per page.
Request Body schema:

An ImageFilterParameters object specifying the parameters for the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Filters
required
Array of strings (ImageFilters)
Items Enum: "addNoise" "aqua" "blur" "diffuse" "fire" "grayscale" "sepia" "negative" "pixelize" "relief" "scanLine" "sharpen" "smooth" "edgeEnhancement" "contour" "emboss" "engrave" "dilate" "erode" "connectedContour" "soften" "colorize" "gaussian" "max" "min" "subtractBackground" "unsharpmask"

Specifies an array of filters to be applied. A maximum of 5 entries is supported.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to apply the filter(s) to.

ColorizeHue
number <float>
Default: 0

Hue for the colorization effect (if enabled) [0..100].

ColorizeLuminosity
number <float>
Default: 0

Luminosity for the colorization effect (if enabled) [0..100].

ColorizeSaturation
number <float>
Default: 0

Saturation for the colorization effect (if enabled) [0..100].

GaussianKernelSize
integer <int32>
Default: 3

Specifies the kernel size for the Gaussian filter (if enabled). The size of the square kernel to use. Should be a odd value. For example, a size of 3 will involve 3 * 3 pixels in each pass. The larger the value the more blur you get. The range is larger or equal than 3, and less than the Image's Smaller Dimension (Width, Height) divided by 2. Suggested value is 3 for a [96-120] DPI image and 5 for a [200-250] dpi bitmap.

MaxKernelSize
integer <int32>
Default: 2

Specifies the kernel size for the maximum filter (if enabled). How much smaller should objects become in each direction of the four directions, left, right, top, and bottom. This value should be larger than 1 and smaller than Image's Smaller Dimension (Width or Height) divided by 2.

MedianKernelSize
integer <int32>
Default: 4

Specifies the kernel size for the median filter (if enabled). Level corresponding to number of pixels to include in the median operation, where Level = n, corresponds to (n*2+1)^2 pixels to be included. For Example, KernelSize = 1 includes 9 pixels in the median operation, KernelSize = 2 includes 25 pixels in the median operation. Range from 1 to 60.

MinKernelSize
integer <int32>
Default: 2

Specifies the kernel size for the minimum filter (if enabled). How large should objects grow in each direction of the four directions, left, right, top, and bottom This value should be larger than 1 and smaller than Image's Smaller Dimension (Width or Height) divided by 2.

RoiHeight
integer <int32>
Default: 0

Specifies the height, in pixel, of the region to process. 0 causes the entire image to be processed.

RoiLeft
integer <int32>
Default: 0

Specifies the left coordinate, in pixel, of the region to process.

RoiTop
integer <int32>
Default: 0

Specifies the top coordinate, in pixel, of the region to process.

RoiWidth
integer <int32>
Default: 0

Specifies the width, in pixel, of the region to process. 0 causes the entire image to be processed.

SoftenValue
integer <int32>
Default: 0

Specifies the value for the soften filter (if enabled). Factor between 1 and 100.

SubtractBackgroundLightBackground
boolean
Default: true

Whether a background is lighter or not than the foreground.Value >= true.

SubtractBackgroundRollingBallSize
integer <int32>
Default: 50

Size of ball rolled under the image. Controlled the amount of subtraction. Value >= 50.

UnsharpMaskAmount
number <double>
Default: 0.5

Amount of Contrast to be added to areas of edges where filter will be applies. It controls how much darker and how much brighter the edges become. Proper value is 0.5, Value between 0.0-5.0.

UnsharpMaskRadius
integer <int32>
Default: 5

Size of Edges to become after the unsharp mask effect is applied. It controls how wide they get after the filter is applied. Radius and Amount interact, reducing one, allows more of the other. Minimum Value of Radius should be 3 or more to allow for enough pixels surrounding the edge to be investigated. If value passed less than 3 is passed it will be ammended automatically to 3. Proper value is 5. Value >= 3.

UnsharpMaskThreshold
integer <int32>
Default: 40

Specifies the amount of edges to be sharpened. Smaller values sharpen more, higher values exclude the subtle edges from being sharpened. Proper value is 40. Value between 0-255.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string",
  • "Filters": [
    ]
}

Response samples

Content type
No sample

ImageGetPageThumbnail

Gets a thumbnail of each page within the provided page range from a previously uploaded image.
1 token is charged per page.
Request Body schema:

A PDFGetPageThumbnailParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the page or the range of pages to get a thumbnail from.

ThumbnailHeight
integer <int32>
Default: 220

Specifies the height, in points, of the thumbnail(s). The minimum and maximum values are respectively 1 and 4096.

ThumbnailWidth
integer <int32>
Default: 140

Specifies the width, in points, of the thumbnail(s). The minimum and maximum values are respectively 1 and 4096.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageImage)

Contains all the obtained thumbnails.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ImageGetSupportedFileExtensions

Gets the supported file extensions by the image loading actions.
No token is charged for this operation.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Value
Array of strings or null

The response value.

Response samples

Content type
No sample

ImageLoad

Loads the provided image file. Supported image formats can be retrieved by the GetSupportedImageFileExtensions action.
1 token is charged per 10 MB of the input file size.
Request Body schema:

A LoadImageFromByteArrayParameters object specifying the parameters of the action.

Content
required
string <byte>

Specifies the data of the image.

ContentEncoding
string
Default: "Identity"
Enum: "Identity" "Gzip"

Indicates the encoding mode of data.

FileName
string or null

Specifies the name of the document.

GetPreview
boolean
Default: false

Specifies whether the response must contain a thumbnail of the first page of the document.

ThumbnailBackgroundColor
string or null
Default: "rgba(0,0,0,0)"

Specifies the background color of the thumbnail, using the color name (ie: "red") or its RGBa code (ie: "rgba(255,0,0,1)"). Only applicable if GetPreview has been set to true.

ThumbnailFitToPageSize
boolean
Default: true

Specifies if the size of the produced thumbnail is automatically adjusted to don't have any margin. Only applicable if GetPreview has been set to true.

ThumbnailHeight
integer <int32>
Default: 220

Specifies, in pixels, the height of the thumbnail to be retrieved. Only applicable if GetPreview has been set to true.

ThumbnailWidth
integer <int32>
Default: 140

Specifies, in pixels, the width of the thumbnail to be retrieved. Only applicable if GetPreview has been set to true.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

FileId
string or null

Specifies the file identifier of the loaded image document.

FileSize
integer <int64>

Specifies the size of the loaded image file.

ImageFormat
string
Default: "UNKNOWN"
Enum: "UNKNOWN" "ICO" "BMP" "WBMP" "JPEG" "GIF" "PNG" "TIFF" "FAXG3" "EXIF" "EMF" "WMF" "JNG" "KOALA" "IFF" "MNG" "PCD" "PCX" "PBM" "PBMRAW" "PFM" "PGM" "PGMRAW" "PPM" "PPMRAW" "RAS" "TARGA" "PSD" "CUT" "XBM" "XPM" "DDS" "HDR" "SGI" "EXR" "J2K" "JP2" "PICT" "RAW" "WEBP" "DICOM" "JBIG" "JBIG2" "WSQ" "PDF" "SVG" "TXT" "DOCX" "RTF" "DXF" "ODT" "XLSX" "PPTX" "DOC" "XLS" "PPT" "HTML" "HEIF" "MSG" "EML" "PostScript"

Specifies the format of a document.

PageCount
integer <int32>

Specifies the number of pages into the loaded image.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

ThumbnailData
string or null <byte>

Specifies the data of a thumbnail from the first page of the document, in PNG format. Only applicable if the GetPreview field of the request has been set to true.

Request samples

Content type
{
  • "Content": "string"
}

Response samples

Content type
No sample

ImageLoadMultipart

Loads the provided image file using Multipart Upload. Supported image formats can be retrieved by the GetSupportedImageFileExtensions action.
1 token is charged per 10 MB of the input file size.
Request Body schema: multipart/form-data
fileData
required
string <binary>
object (LoadImageParameters)

Represents the parameters for importing an image.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

FileId
string or null

Specifies the file identifier of the loaded image document.

FileSize
integer <int64>

Specifies the size of the loaded image file.

ImageFormat
string
Default: "UNKNOWN"
Enum: "UNKNOWN" "ICO" "BMP" "WBMP" "JPEG" "GIF" "PNG" "TIFF" "FAXG3" "EXIF" "EMF" "WMF" "JNG" "KOALA" "IFF" "MNG" "PCD" "PCX" "PBM" "PBMRAW" "PFM" "PGM" "PGMRAW" "PPM" "PPMRAW" "RAS" "TARGA" "PSD" "CUT" "XBM" "XPM" "DDS" "HDR" "SGI" "EXR" "J2K" "JP2" "PICT" "RAW" "WEBP" "DICOM" "JBIG" "JBIG2" "WSQ" "PDF" "SVG" "TXT" "DOCX" "RTF" "DXF" "ODT" "XLSX" "PPTX" "DOC" "XLS" "PPT" "HTML" "HEIF" "MSG" "EML" "PostScript"

Specifies the format of a document.

PageCount
integer <int32>

Specifies the number of pages into the loaded image.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

ThumbnailData
string or null <byte>

Specifies the data of a thumbnail from the first page of the document, in PNG format. Only applicable if the GetPreview field of the request has been set to true.

Response samples

Content type
No sample

ImageReadBarcodes

Reads barcodes from a previously uploaded image.
2 tokens are charged per page.
Request Body schema:

An ImageReadBarcodesParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to read the barcodes from.

RoiHeight
integer <int32>
Default: 0

Specifies the height, in pixel, of the region to process. 0 causes the entire image to be processed.

RoiLeft
integer <int32>
Default: 0

Specifies the left coordinate, in pixel, of the region to process.

RoiTop
integer <int32>
Default: 0

Specifies the top coordinate, in pixel, of the region to process.

RoiWidth
integer <int32>
Default: 0

Specifies the width, in pixel, of the region to process. 0 causes the entire image to be processed.

ScanBarcode1D
boolean
Default: true

Specifies whether the barcodes of type 1D shall be read.

ScanBarcodeAztec
boolean
Default: true

Specifies whether the barcodes of type Aztec shall be read.

ScanBarcodeDataMatrix
boolean
Default: true

Specifies whether the barcodes of type Data Matrix shall be read.

ScanBarcodeMaxiCode
boolean
Default: true

Specifies whether the barcodes of type MaxiCode shall be read.

ScanBarcodeMicroQR
boolean
Default: true

Specifies whether the barcodes of type Micro QR shall be read.

ScanBarcodePDF417
boolean
Default: true

Specifies whether the barcodes of type PDF 147 shall be read.

ScanBarcodeQR
boolean
Default: true

Specifies whether the barcodes of type QR shall be read.

ScanMode
string
Default: "FavorAccuracy"
Enum: "FavorSpeed" "FavorAccuracy"

Defines the different available scan modes.

Responses

Response Schema:
Array of objects or null (BarcodeInfo)

Specifies the information of the different barcodes which have been read.

object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ImageReadMICR

Performs MICR (Magnetic Ink Character Recognition) recognition on any kind of document, of any format, from any source.
1 token is charged per page.
Request Body schema:

An ImageReadMICRParameters object specifying the parameters of the action.

Context
required
string
Default: "LineFinding"
Enum: "LineFinding" "WholeDocument"

Specifies the MICR context, i.e. the layout type of the data to be recognized. .

Font
required
string
Default: "E13B"
Enum: "E13B" "CMC7"

Specifies the two major MICR fonts in use.

PageRange
required
string non-empty

Specifies the page or the range of page to be processed.

ExpectedSymbolsCount
integer <int32>
Default: 0

Specifies the number of symbols expected to be detected, use 0 if unknown.

FileContent
string or null <byte>

If non empty, specifies the content of the file to be processed.

FileId
string or null

If non empty, specifies the identifier of the previously uploaded file to be processed.

RoiHeight
integer <int32>
Default: 0

Specifies the height, in pixel, of the region to process. 0 causes the entire image to be processed.

RoiLeft
integer <int32>
Default: 0

Specifies the left coordinate, in pixel, of the region to process.

RoiTop
integer <int32>
Default: 0

Specifies the top coordinate, in pixel, of the region to process.

RoiWidth
integer <int32>
Default: 0

Specifies the width, in pixel, of the region to process. 0 causes the entire image to be processed.

Uri
string or null

If non empty, specifies the uri of the file to be processed.

WhiteList
string or null
Default: ""

Specifies the characters to be ignored by the recognition process.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Array of objects or null (MICRResult)

Holds the results of the MICR operations.

Request samples

Content type
{
  • "PageRange": "string",
  • "Font": "E13B",
  • "Context": "LineFinding"
}

Response samples

Content type
No sample

ImageReadMRZ

Performs MRZ (Machine-Readable Zone) recognition on any kind of document, of any format, from any source.
1 token is charged per page.
Request Body schema:

An ImageReadMRZParameters object specifying the parameters of the action.

PageRange
required
string non-empty

Specifies the page or the range of page to be processed.

FileContent
string or null <byte>

If non empty, specifies the content of the file to be processed.

FileId
string or null

If non empty, specifies the identifier of the previously uploaded file to be processed.

Uri
string or null

If non empty, specifies the uri of the file to be processed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Array of objects or null (MRZResult)

Holds the results of the MRZ recognition operations.

Request samples

Content type
{
  • "PageRange": "string"
}

Response samples

Content type
No sample

ImageResize

Resizes a previously uploaded image.
2 tokens are charged per page.
Request Body schema:

An ImageResizeParameters object specifying the parameters for the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to resize.

ResizeHorizontal
required
number <float>

Specifies the resize horizontal parameter.

ResizeVertical
required
number <float>

Specifies the resize vertical parameter.

ResizeMode
string
Default: "Auto"
Enum: "Auto" "NearestNeighbor" "Box" "Lanczos3" "Bilinear" "Bicubic" "Bspline" "CatmullRomSpline"

The algorithm to be used during resizing.

ResizeUnit
string
Default: "Pixel"
Enum: "Pixel" "Percent"

Specifies the unit of measure for the given data.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string",
  • "ResizeHorizontal": 0,
  • "ResizeVertical": 0
}

Response samples

Content type
No sample

ImageRotate

Rotates and/or flips a previously uploaded image.
1 token is charged per page.
Request Body schema:

An ImageRotateParameters object specifying the parameters for the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to rotate.

RotationAngle
required
number <float>

Specifies the rotation angle, clockwise in degrees, which can be either positive and negative and any multiple of 90.

FlipHorizontally
boolean
Default: false

Specifies whether the page(s) shall be flipped horizontally.

FlipVertically
boolean
Default: false

Specifies whether the page(s) shall be flipped vertically.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string",
  • "RotationAngle": 0
}

Response samples

Content type
No sample

ImageSaveAsJPEG

Saves a previously uploaded image as JPEG, and sends the file data in a JSON-serialized object.
1 token is charged per page.
Request Body schema:

An ImageSaveAsJPEGParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

JPEGSubsamplingMode
string
Default: "Default"
Enum: "Default" "Y4Cb1Cr1" "Y4Cb2Cr0" "Y4Cb2Cr2" "Y4Cb4Cr4"

Specifies the different available chroma subsampling mode for image compression in JPEG images.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as JPEG.

Progressive
boolean
Default: false

Specifies if the encoded JPEG image must be progressive.

Quality
integer <int32>
Default: 75

Specifies the level of quality to be used for the JPEG compression, from 1 (poorest) to 100 (greatest).

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageImage)

The image(s) saved as JPEG.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsJPEG2000

Saves a previously uploaded image as JPEG2000, and sends the file data in a JSON-serialized object.
1 token is charged per page.
Request Body schema:

An ImageSaveAsJPEG2000Parameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as JPEG2000.

Quality
integer <int32>
Default: 75

Specifies the level of quality to be used for the JPEG2000 compression, from 1 (poorest) to 100 (greatest).

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageImage)

The image(s) saved as JPEG2000.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsJPEG2000File

Saves a previously uploaded image as JPEG2000, and streams the file binary data to the response (this is the most efficient download method).
1 token is charged per page.
Request Body schema:

An ImageSaveAsJPEGParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as JPEG2000.

Quality
integer <int32>
Default: 75

Specifies the level of quality to be used for the JPEG2000 compression, from 1 (poorest) to 100 (greatest).

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsJPEGFile

Saves a previously uploaded image as JPEG, and streams the file binary data to the response (this is the most efficient download method).
1 token is charged per page.
Request Body schema:

An ImageSaveAsJPEGParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

JPEGSubsamplingMode
string
Default: "Default"
Enum: "Default" "Y4Cb1Cr1" "Y4Cb2Cr0" "Y4Cb2Cr2" "Y4Cb4Cr4"

Specifies the different available chroma subsampling mode for image compression in JPEG images.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as JPEG.

Progressive
boolean
Default: false

Specifies if the encoded JPEG image must be progressive.

Quality
integer <int32>
Default: 75

Specifies the level of quality to be used for the JPEG compression, from 1 (poorest) to 100 (greatest).

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsPDF

Saves a previously uploaded image as PDF, and sends the file data in a JSON-serialized object.
1 token is charged per page.
Request Body schema:

An ImagesaveAsPDFParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

BitonalImageCompression
string
Default: "JBIG2"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

ColorImageCompression
string
Default: "JPEG"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

Conformance
string
Default: "PDF15"
Enum: "Unknown" "PDF10" "PDF11" "PDF12" "PDF13" "PDF14" "PDF15" "PDF16" "PDF17" "PDF20" "PDFA1a" "PDFA1b" "PDFA2a" "PDFA2u" "PDFA2b" "PDFA3a" "PDFA3u" "PDFA3b" "PDFUA1" "PDFA4" "PDFA4e" "PDFA4f"

Specifies PDF versions and conformance levels of a PDF document.

DownscaleResolution
integer <int32>
Default: 0

Specifies the resolution for downscaling images, if any. A value of 0 results in no downscaling.

EnableColorDetection
boolean
Default: false

Specifies is color detection must be used.

FastWebView
boolean
Default: false

Specifies whether the PDF shall be optimized for online distribution.

ImageQuality
integer <int32>
Default: 75

Specifies the quality to be used for the compression of the images from the PDF. Must be in the range [0 (best compression - worst quality) - 100 (worst quality - best compression)].

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as PDF.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

FileName
string or null

Specifies the name of the saved document.

PdfData
string or null <byte>

Specifies the data of the produced PDF.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsPDFFile

Saves a previously uploaded image as PDF, and streams the file binary data to the response (this is the most efficient download method).
1 token is charged per page.
Request Body schema:

An ImagesaveAsPDFParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

BitonalImageCompression
string
Default: "JBIG2"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

ColorImageCompression
string
Default: "JPEG"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

Conformance
string
Default: "PDF15"
Enum: "Unknown" "PDF10" "PDF11" "PDF12" "PDF13" "PDF14" "PDF15" "PDF16" "PDF17" "PDF20" "PDFA1a" "PDFA1b" "PDFA2a" "PDFA2u" "PDFA2b" "PDFA3a" "PDFA3u" "PDFA3b" "PDFUA1" "PDFA4" "PDFA4e" "PDFA4f"

Specifies PDF versions and conformance levels of a PDF document.

DownscaleResolution
integer <int32>
Default: 0

Specifies the resolution for downscaling images, if any. A value of 0 results in no downscaling.

EnableColorDetection
boolean
Default: false

Specifies is color detection must be used.

FastWebView
boolean
Default: false

Specifies whether the PDF shall be optimized for online distribution.

ImageQuality
integer <int32>
Default: 75

Specifies the quality to be used for the compression of the images from the PDF. Must be in the range [0 (best compression - worst quality) - 100 (worst quality - best compression)].

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as PDF.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsPDFMRC

Saves a previously uploaded image as PDF using MRC compression, and sends the file data in a JSON-serialized object.
4 tokens are charged per page.
Request Body schema:

An ImagesaveAsPDFMRCParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Author
string or null
Default: ""

Specifies the author's name specified within the PDF to generate.

AutoRotate
boolean
Default: false

Specifies whether automatic page rotation is activated.

BitonalImageCompression
string
Default: "JBIG2"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

ColorImageCompression
string
Default: "JPEG2000"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

Conformance
string
Default: "PDF15"
Enum: "Unknown" "PDF10" "PDF11" "PDF12" "PDF13" "PDF14" "PDF15" "PDF16" "PDF17" "PDF20" "PDFA1a" "PDFA1b" "PDFA2a" "PDFA2u" "PDFA2b" "PDFA3a" "PDFA3u" "PDFA3b" "PDFUA1" "PDFA4" "PDFA4e" "PDFA4f"

Specifies PDF versions and conformance levels of a PDF document.

DownscaleResolution
integer <int32>
Default: 100

Specifies the resolution for downscaling the background layer, if any. A value of 0 results in no downscaling.

FastWebView
boolean
Default: false

Specifies whether the PDF shall be optimized for online distribution.

ImageQuality
integer <int32>
Default: 60

Specifies the quality to be used for the compression of the images from the PDF. Must be in the range [0 (best compression - worst quality) - 100 (worst quality - best compression)].

JBIG2PMSThreshold
number <float>
Default: 0.85

Specifies the threshold value for the JBIG2 encoder pattern matching and substitution between 0.4 and 1. Any number lower than 1 may lead to lossy compression.

Keywords
string or null
Default: ""

Specifies the keywords associated with the PDF to generate0

Metadata
string or null
Default: ""

Specifies the metadata contained within the PDF to generate0

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as PDF MRC.

PreserveSmoothing
boolean
Default: false

Specifies whether the MRC engine should try to preserve smoothing between different layers. Enabling this option should globally enhance the text quality but also reduce the compression rate.

Producer
string or null
Default: ""

Specifies the producer's name specified within the PDF to generate.

Subject
string or null
Default: ""

Specifies the document's subject specified within the PDF to generate.

Title
string or null
Default: ""

Specifies the document's title specified within the PDF to generate.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

FileName
string or null

Specifies the name of the saved document.

PdfData
string or null <byte>

Specifies the data of the produced PDF.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsPDFMRCFile

Saves a previously uploaded image as PDF using MRC compression, and streams the file binary data to the response (this is the most efficient download method).
4 tokens are charged per page.
Request Body schema:

An ImagesaveAsPDFMRCParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Author
string or null
Default: ""

Specifies the author's name specified within the PDF to generate.

AutoRotate
boolean
Default: false

Specifies whether automatic page rotation is activated.

BitonalImageCompression
string
Default: "JBIG2"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

ColorImageCompression
string
Default: "JPEG2000"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

Conformance
string
Default: "PDF15"
Enum: "Unknown" "PDF10" "PDF11" "PDF12" "PDF13" "PDF14" "PDF15" "PDF16" "PDF17" "PDF20" "PDFA1a" "PDFA1b" "PDFA2a" "PDFA2u" "PDFA2b" "PDFA3a" "PDFA3u" "PDFA3b" "PDFUA1" "PDFA4" "PDFA4e" "PDFA4f"

Specifies PDF versions and conformance levels of a PDF document.

DownscaleResolution
integer <int32>
Default: 100

Specifies the resolution for downscaling the background layer, if any. A value of 0 results in no downscaling.

FastWebView
boolean
Default: false

Specifies whether the PDF shall be optimized for online distribution.

ImageQuality
integer <int32>
Default: 60

Specifies the quality to be used for the compression of the images from the PDF. Must be in the range [0 (best compression - worst quality) - 100 (worst quality - best compression)].

JBIG2PMSThreshold
number <float>
Default: 0.85

Specifies the threshold value for the JBIG2 encoder pattern matching and substitution between 0.4 and 1. Any number lower than 1 may lead to lossy compression.

Keywords
string or null
Default: ""

Specifies the keywords associated with the PDF to generate0

Metadata
string or null
Default: ""

Specifies the metadata contained within the PDF to generate0

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as PDF MRC.

PreserveSmoothing
boolean
Default: false

Specifies whether the MRC engine should try to preserve smoothing between different layers. Enabling this option should globally enhance the text quality but also reduce the compression rate.

Producer
string or null
Default: ""

Specifies the producer's name specified within the PDF to generate.

Subject
string or null
Default: ""

Specifies the document's subject specified within the PDF to generate.

Title
string or null
Default: ""

Specifies the document's title specified within the PDF to generate.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsPNG

Saves a previously uploaded image as PNG, and sends the file data in a JSON-serialized object.
1 token is charged per page.
Request Body schema:

An ImageSaveAsPNGParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
integer <int32>
Default: 6

Specifies the level of compression to be used for the PNG output, between 0 (no compression - faster encoding) to 9(max compression - slower encoding).

Interlaced
boolean
Default: false

Specifies if the produced PNG image must be interlaced.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as PNG.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageImage)

The image(s) saved as PNG.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsPNGFile

Saves a previously uploaded image as PNG, and streams the file binary data to the response (this is the most efficient download method).
1 token is charged per page.
Request Body schema:

An ImageSaveAsPNGParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
integer <int32>
Default: 6

Specifies the level of compression to be used for the PNG output, between 0 (no compression - faster encoding) to 9(max compression - slower encoding).

Interlaced
boolean
Default: false

Specifies if the produced PNG image must be interlaced.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as PNG.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsTIFF

Saves a previously uploaded image as TIFF, and sends the file data in a JSON-serialized object.
1 token is charged per page.
Request Body schema:

An ImageSaveAsTIFFParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
string
Default: "Auto"
Enum: "Deflate" "CCITT3" "CCITT4" "LZW" "JPEG" "RLE" "Auto"

Specifies the TIFF compression when saving images in TIFF format.

JpegQuality
integer <int32>
Default: 75

Specifies the level of quality to be used if JPEG compression is used, from 1 (poorest) to 100 (greatest).

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as TIFF.

UseCMYK
boolean
Default: false

Specifies whether the TIFF shall be saved in CMYK color space or not.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageImage)

The image(s) saved as TIFF.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsTIFFFile

Saves a previously uploaded image as TIFF, and streams the file binary data to the response (this is the most efficient download method).
1 token is charged per page.
Request Body schema:

An ImageSaveAsTIFFParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
string
Default: "Auto"
Enum: "Deflate" "CCITT3" "CCITT4" "LZW" "JPEG" "RLE" "Auto"

Specifies the TIFF compression when saving images in TIFF format.

JpegQuality
integer <int32>
Default: 75

Specifies the level of quality to be used if JPEG compression is used, from 1 (poorest) to 100 (greatest).

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as TIFF.

UseCMYK
boolean
Default: false

Specifies whether the TIFF shall be saved in CMYK color space or not.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsTIFFMultipage

Saves a previously uploaded image as multipage TIFF, and sends the file data in a JSON-serialized object.
1 token is charged per page.
Request Body schema:

An ImageSaveAsTIFFMultipageParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
string
Default: "Auto"
Enum: "Deflate" "CCITT3" "CCITT4" "LZW" "JPEG" "RLE" "Auto"

Specifies the TIFF compression when saving images in TIFF format.

JpegQuality
integer <int32>
Default: 75

Specifies the level of quality to be used if JPEG compression is used, from 1 (poorest) to 100 (greatest).

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as TIFF.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

FileName
string or null

Specifies the name of the saved document.

ImageData
string or null <byte>

Specifies the data of the produced multipage TIFF.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSaveAsTIFFMultipageFile

Saves a previously uploaded image as multipage TIFF, and streams the file binary data to the response (this is the most efficient download method).
1 token is charged per page.
Request Body schema:

An ImageSaveAsTIFFMultipageParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
string
Default: "Auto"
Enum: "Deflate" "CCITT3" "CCITT4" "LZW" "JPEG" "RLE" "Auto"

Specifies the TIFF compression when saving images in TIFF format.

JpegQuality
integer <int32>
Default: 75

Specifies the level of quality to be used if JPEG compression is used, from 1 (poorest) to 100 (greatest).

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as TIFF.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ImageSwapPages

Swaps two pages from a previously uploaded image.
1 token is charged per request.
Request Body schema:

An ImageSwapPagesParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Page1
required
integer <int32>

Specifies the number of the first page.

Page2
required
integer <int32>

Specifies the number of the second page.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "Page1": 0,
  • "Page2": 0
}

Response samples

Content type
No sample

PassportManager

Retrieve information about passports.

PassportManagerGetPassportInfo

No token is charged for this operation.

query Parameters
passportId
required
string

Responses

Response Schema:
CurrentTokensUsed
integer <int64>
ExpirationDate
string or null <date-time>
ExtraTokens
integer <int64>
ExtraTokensEndDate
string or null <date-time>
IsActive
boolean
IsManaged
boolean
IsYearlyPaid
boolean
NextMonthlyTerm
string <date-time>
OptionalLinkedSubscriptionId
string or null
PassportId
string or null
PlanId
integer <int32>
RemainingTokens
integer <int64>
SubscriptionDate
string or null <date-time>
SubscriptionId
string or null
SubscriptionProvider
string or null
TokensPercentUsageAlert
integer <int32>
TokensPercentUsageAlertSent
boolean

Response samples

Content type
No sample

PassportPDFApplicationManager

Retrieve information about PassportPDF desktop applications.

PassportPDFApplicationManagerGetApplicationLatestVersion

No token is charged for this operation.

query Parameters
applicationId
required
string

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Value
string or null

The response value.

Response samples

Content type
No sample

PassportPDFApplicationManagerGetApplicationMinimumSupportedVersion

No token is charged for this operation.

query Parameters
applicationId
required
string

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Value
string or null

The response value.

Response samples

Content type
No sample

PassportPDFApplicationManagerGetMaxClientThreads

Gets the maximum number of threads to be used simultaneously by a client application.
No token is charged for this operation.
query Parameters
applicationId
required
string

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Value
integer <int32>

The response value.

Response samples

Content type
No sample

PDF

All the PDF-related APIs.

Annotate

Annotates a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfAnnotateParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the page or the range of page to be annotated.

AnnotationType
string
Default: "StickyNote"
Enum: "StickyNote" "Link" "FreeText" "Line" "Square" "Circle" "RubberStamp"

Defines the different available types of annotations.

object (FreeTextAnnotationParameters)

Represents information about the FreeText Annotation.

object (LineAnnotationParameters)

Represents information about the Line Annotation.

object (LinkAnnotationParameters)

Represents information about the Link Annotation.

object (RubberStampAnnotationParameters)

Represents information about the Rubber Stamp Annotation.

object (SquareAndCircleAnnotationParameters)

Represents information about the Square / Circle Annotation.

object (StickyNoteAnnotationParameters)

Represents information about the Sticky Note Annotation.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

AutoCrop

Automatically crops a page range from a previously uploaded PDF, based on page content.
2 tokens are charged per request.
Request Body schema:

A PdfAutoCropParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

MarginBottom
required
number <float>

Specifies, in points, the width of the bottom margin for the cropped content;

MarginLeft
required
number <float>

Specifies, in points, the width of the left margin for the cropped content.

MarginRight
required
number <float>

Specifies, in points, the width of the right margin for the cropped content.

MarginTop
required
number <float>

Specifies, in points, the width of the top margin for the cropped content.

PageRange
string or null
Default: "*"

Specifies the page or the range of pages to be cropped.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "MarginLeft": 0,
  • "MarginTop": 0,
  • "MarginRight": 0,
  • "MarginBottom": 0
}

Response samples

Content type
No sample

AutoDeskew

Performs auto deskew on a page range of a previously uploaded document.
1 token is charged per page.
Request Body schema:

A PdfAutoDeskewParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the page or the page range to be auto-deskewed.

MaxAngleOfResearch
number <float>
Default: 15

Specifies the maximum skew angle to be detected. A value of below 15 is suggested.

Optimistic
boolean
Default: false

Specifies whether the skew detection engine must be optimistic when detecting angles. If you know the image is skewed, you should set this to true.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ClearPage

Clears a page range from a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfClearPageParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the page or the range of pages to be cleared.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ClonePage

Clones specific pages from a previously uploaded document to another previously uploaded document.
2 tokens are charged per request.
Request Body schema:

A PdfClonePageParameters object specifying the parameters of the action.

DestinationPage
required
integer <int32>

Specifies the number of the page where the cloned page(s) shall be inserted. If a value inferior to 0 or greater than the total number of page of the PDF is provided, the page(s) shall be inserted respectively at the beginning or the end of the PDF.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to be cloned.

SourceFileId
required
string non-empty

Specifies the file identifier of the PDF to be cloned.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "SourceFileId": "string",
  • "PageRange": "string",
  • "DestinationPage": 0
}

Response samples

Content type
No sample

ClosePDF

Closes a previously uploaded document.
No token is charged for this operation.
Request Body schema:

A PdfCloseDocumentParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ConvertToGrayscale

Converts a page range of a previously uploaded PDF to grayscale.
5 tokens are charged per request.
Request Body schema:

A PdfConvertToGrayscaleParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Annotations
boolean
Default: true

Specifies whether the annotations shall be converted to grayscale.

FormFields
boolean
Default: true

Specifies whether the form fields shall be converted to grayscale.

Graphics
boolean
Default: true

Specifies whether the path-based graphic objects shall be converted to grayscale.

Images
boolean
Default: true

Specifies whether the images shall be converted to grayscale.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be converted to grayscale.

Text
boolean
Default: true

Specifies whether the text shall be converted to grayscale.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ConvertToPDFA

Converts a previously uploaded document to PDF/A.
10 tokens are charged per request.
Request Body schema:

A PdfConvertToPDFAParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

AllowRasterization
boolean
Default: true

If set to true, conversion engine will use the page rasterization in case direct conversion and verorization are not possible or allowed.

AllowVectorization
boolean
Default: true

If set to true, conversion engine will use the page vectorization in case direct conversion is not possible.

Conformance
string
Default: "PDFA2b"
Enum: "PDFA1a" "PDFA1b" "PDFA2a" "PDFA2b" "PDFA2u" "PDFA3a" "PDFA3b" "PDFA3u" "PDFA4" "PDFA4e" "PDFA4f"

Specifies the different available PDF/A conformance levels.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

DeletePage

Deletes a page range from a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfDeletePageParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to be deleted.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

DetectPageOrientation

Detects the orientation of the page(s) of a previously uploaded document and offers to automatically rotate them.
1 token is charged per page.
Request Body schema:

A PdfDetectPageOrientationParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to be processed.

AutomaticallyApplyRotation
boolean
Default: true

Specifies whether a rotation shall be automatically applied in order to correct the page orientation when needed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageOrientationInfo)

Holds information about the detected page orientations.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

DigiSign

Signs a previously uploaded document digitally.
5 tokens are charged per request.
Request Body schema:

A PdfDigiSignParameters object specifying the parameters of the action.

CertificateData
required
string <byte>

Specifies the data of the digital PKCS#12 certificate file.

CertificatePassword
required
string non-empty

Specifies the certificate password.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

ContactInfo
string or null
Default: ""

Specifies contact information about the signer.

DrawSignature
boolean
Default: false

Specifies whether the signature shall be drawn on the document.

ImageData
string or null <byte>

Specifies the data of the image to be drawn at the signature location. This parameter is used only when the signature is requested to be drawn.

Linearize
boolean
Default: false

Specifies whether the signed PDF shall be linearized.

Location
string or null
Default: ""

Specifies the location where the signature is applied.

PageNumber
integer <int32>
Default: 1

Specifies the number of the page on which the signature shall be drawn. This parameter is used only when the signature is requested to be drawn. If the page number is invalid, the signature shall be applied on the first page.

Reason
string or null
Default: ""

Specifies the reason of the signature.

ShowValidationMark
boolean
Default: false
SignatureCertificationLevel
string
Default: "NotCertified"
Enum: "NotCertified" "NoChanges" "FormFilling" "FormFillingAndAnnotations"

Specifies the level of the signature certification.

SignatureHashAlgorithm
string
Default: "SHA256"
Enum: "SHA1" "SHA256" "SHA512" "SHA224" "SHA384"

Specifies the SHA (hash) algorithm to use while signing.

object (DrawableContentLayoutParameters)

Represents information about the layout of a content, on the page it is drawn onto.

SignatureMode
string
Default: "AdobePPKMS"
Enum: "AdobePPKMS" "AdobePPKLite" "AdobeCADES"

Specifies the security handler of a signature.

object (PdfAlignedTextParameters)

Represents the parameters for aligned text content.

SignerName
string or null
Default: "PassportPDF"

Specifies the name of the signer.

TimeStampPassword
string or null
Default: ""

Specifies the optional password associated with the time stamp server.

TimeStampURL
string or null
Default: ""

Specifies the URL of the server responsible of providing a time stamp.

TimeStampUserName
string or null
Default: ""

Specifies the optional user name associated with the time stamp server.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "CertificateData": "string",
  • "CertificatePassword": "string"
}

Response samples

Content type
No sample

DrawImage

Draws an image on a page range of a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfDrawImageParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the page or the page range on which the image shall be drawn.

BitonalCompression
string
Default: "JBIG2"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

ColorImageCompression
string
Default: "JPEG"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

DrawOnBackground
boolean
Default: false

Specifies whether the image shall be drawn in the background.

ImageData
string or null <byte>

Specifies the data of the image to be drawn. If no image data are provided, the image is loaded using the provided image file ID.

ImageFileId
string or null
Default: ""

Specifies the file ID of the image to be drawn. If no image data are provided, the image is loaded using the provided image file ID.

object (DrawableContentLayoutParameters)

Represents information about the layout of a content, on the page it is drawn onto.

Opacity
number <float>
Default: 100

Specifies the opacity of the image, in the range [0 (fully transparent) : 100 (fully opaque)].

Quality
integer <int32>
Default: 75

Specifies the level of quality to be used for the compression, from 1 (poorest) to 100 (greatest).

Rotation
number <float>
Default: 0

Specifies the rotation applied to the image, in degrees, clockwise.

RotationAt
string
Default: "Centered"
Enum: "TopLeft" "BottomLeft" "Centered" "Custom"

Specifies the rotation center point with respect to the bounding box of the content being added.

RotationCenterX
number <float>
Default: 0

Specifies the absolute horizontal coordinate of the rotation center from the top-left edge of the content, in points.

RotationCenterY
number <float>
Default: 0

Specifies the absolute vertical coordinate of the rotation center from the top-left edge of the content, in points.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ExtractPage

Extracts a page range from a previously uploaded document into one or several new documents.
5 tokens are charged per request.
Request Body schema:

A PdfExtractPageParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to be extracted.

ExtractAsSeparate
boolean
Default: false

Specifies whether each extracted page shall form a separate document.

ImmediateDownload
boolean
Default: false

Specifies whether the file(s) created as a result of the action shall be available for immediate download.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

FileData
Array of strings or null <byte>

Specifies the data of the file(s) created as a result of the action. If immediate download is not requested, no file data will be returned.

FileIds
Array of strings or null

Specifies the identifier(s) of the file(s) created as a result of the action. If immediate download is requested, no file identifier will be returned.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ExtractText

Extracts text from the document pages.
1 token is charged per request.
Request Body schema:

A PdfExtractTextParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to extract text from.

IncludeHeader
boolean
Default: false

Specifies whether the CSV output should include header information. This parameter is only used when the textExtractionMode is set to "WholePageCSV" mode.

TextExtractionAreaHeight
number <float>
Default: 0

Specifies the height of the text extraction area for the PageAreaFormated extract mode. The location of the coordinate system origin used is top-left and the measurement units are inches (1 Inch = 72 points).

TextExtractionAreaLeft
number <float>
Default: 0

Specifies the left coordinate of the text extraction area for the PageAreaFormated extract mode. The location of the coordinate system origin used is top-left and the measurement units are inches (1 Inch = 72 points).

TextExtractionAreaTop
number <float>
Default: 0

Specifies the top coordinate of the text extraction area for the PageAreaFormated extract mode. The location of the coordinate system origin used is top-left and the measurement units are inches (1 Inch = 72 points).

TextExtractionAreaWidth
number <float>
Default: 0

Specifies the width of the text extraction area for the PageAreaFormated extract mode. The location of the coordinate system origin used is top-left and the measurement units are inches (1 Inch = 72 points).

TextExtractionMode
string
Default: "WholePageReadable"
Enum: "WholePageReadable" "PageAreaReadable" "WholePageCSV" "WholePagePreserveLayout" "WholePagePreserveParagraphs"

Defines the different available modes for text extraction.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageText)

The text extraction results from individual pages.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

Flatten

Flattens the form-fields, annotations, and/or the layers of a previously uploaded document.
2 tokens are charged per request.
Request Body schema:

A PdfFlatten object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

FlattenAnnotations
boolean
Default: false

Specifies whether the annotations shall be flattened.

FlattenFormFields
boolean
Default: false

Specifies whether the form-fields shall be flattened.

FlattenLayers
boolean
Default: false

Specifies whether the layers shall be flattened.

PageRange
string or null
Default: "*"

Specifies the range of page whose form-fields and annotations shall be flattened, if any.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

GetInfo

Gets information about a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfGetInfoParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Responses

Response Schema:
Author
string or null

Specifies the author name specified within the PDF, if any.

CanAddNotes
boolean

Specifies if the user is allowed to add annotations.

CanAssemble
boolean

Specifies if the user is allowed to assemble the document.

CanCopy
boolean

Specifies if the user is allowed to copy or extract text and graphics from the document.

CanCopyAccess
boolean

Specifies if the user is allowed for copying or extracting for use with accessibility features.

CanFillFields
boolean

Specifies if the user is allowed to fill-in form fields.

CanModify
boolean

Specifies if the user is allowed to modify the document.

CanPrint
boolean

Specifies if the user is allowed to print the document, but possibly not at the highest quality level.

CanPrintFull
boolean

Specifies if the user is allowed to print the document with high resolution.

CreationDate
string or null

Specifies the date and time the document was created, as set in the document information dictionary.

Encryption
string
Default: "PdfEncryptionNone"
Enum: "PdfEncryptionNone" "PdfEncryption40BitRC4" "PdfEncryption128BitRC4" "PdfEncryption128BitAES" "PdfEncryption256BitAES"

Specifies the encryption algorithm.

object (Error)

Contains all the information related to an error which has occurred.

HasOwnerPassword
boolean

Specifies if the PDF is protected with a owner password.

HasUserPassword
boolean

Specifies if the PDF is protected with a user password.

IsLinearized
boolean

Specifies whether the document is a valid linearized PDF (optimized for web viewing).

IsTagged
boolean

Specifies whether the document conforms to Tagged PDF conventions.

Keywords
string or null

Specifies the keywords associated with the PDF, if any.

Metadata
string or null

Specifies the metadata contained within the PDF, if any.

ModificationDate
string or null

Specifies the date and time the document was last modified, as set in the document information dictionary.

PageCount
integer <int32>

Specifies the number of pages of the PDF.

Producer
string or null

Specifies the producer name specified within the PDF, if any.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Subject
string or null

Specifies the document subject specified within the PDF, if any.

Title
string or null

Specifies the document title specified within the PDF, if any.

Version
string or null

Specifies the version of the PDF.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

GetMetadata

Gets the metadata from a previously uploaded PDF as a string in the XMP standardized format.
1 token is charged per request.
Request Body schema:

A PdfGetMetadataParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of a previously uploaded file.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Metadata
string or null

The value of the document's metadata as a string in the XMP standardized format.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

GetPageThumbnail

Gets a thumbnail of each page within the provided page range from a previously uploaded document.
1 token is charged per page.
Request Body schema:

A PdfGetPageThumbnailParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the page or the range of pages to get a thumbnail from.

BackgroundColor
string or null
Default: "rgba(0,0,0,0)"

Specifies the background color of the thumbnail(s), using the color name (ie: "red") or its RGBa code (ie: "rgba(255,0,0,1)").

ThumbnailFitToPageSize
boolean
Default: true

Specifies if the size of the produced thumbnail is automatically adjusted to don't have any margin.

ThumbnailHeight
integer <int32>
Default: 220

Specifies the height, in points, of the thumbnail(s). The minimum and maximum values are respectively 1 and 4096.

ThumbnailWidth
integer <int32>
Default: 140

Specifies the width, in points, of the thumbnail(s). The minimum and maximum values are respectively 1 and 4096.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageImage)

Contains all the obtained thumbnails.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

GetPDFImportSupportedFileExtensions

Gets the supported file extensions by the LoadDocumentAsPDF action.
No token is charged for this operation.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Value
Array of strings or null

The response value.

Response samples

Content type
No sample

InsertImage

Inserts an image on a new page of a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfInsertImageParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the page or the range of pages where the image shall be inserted. Use the total number of page + 1 in order to insert the image after the last page.

BitonalCompression
string
Default: "JBIG2"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

ColorImageCompression
string
Default: "JPEG"
Enum: "None" "Flate" "CCIT4" "JPEG" "JBIG2" "JPEG2000"

Specifies the standard scheme to be used to compress image data in PDF documents.

ImageData
string or null <byte>

Specifies the data of the image to be inserted. If no image data are provided, the image is loaded using the provided image file ID.

ImageFileId
string or null
Default: ""

Specifies the file ID of the image to be drawn. If no image data are provided, the image is loaded using the provided image file ID.

Quality
integer <int32>
Default: 75

Specifies the level of quality to be used for the compression, from 1 (poorest) to 100 (greatest).

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

InsertNewPage

Inserts one or more new blank pages to a specific position in a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfInsertNewPageParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageNumber
required
integer <int32>

Specifies the number of the page where the new page(s) shall be inserted. If a value inferior to 0 or greater than the total number of page of the PDF is provided, the page(s) shall be inserted respectively at the beginning or the end of the PDF.

Height
number <float>
Default: 842

Specifies, in points, the height of the page(s) to be inserted. If the width or the height are left unspecified or set to 0, the page size will be determined from the size of the existing pages. Point is defined as ​1⁄72 or 0.0138 of the international inch, making it equivalent to 0.3527 milimeter. Various standardized paper size definitions can be found at https://en.wikipedia.org/wiki/Paper_size

PageCount
integer <int32>
Default: 1

Specifies the number of pages that must be inserted.

Width
number <float>
Default: 595

Specifies, in points, the width of the page(s) to be inserted. If the width or the height are left unspecified or set to 0, the page size will be determined from the size of the existing pages. Point is defined as ​1⁄72 or 0.0138 of the international inch, making it equivalent to 0.3527 milimeter. Various standardized paper size definitions can be found at https://en.wikipedia.org/wiki/Paper_size

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageNumber": 0
}

Response samples

Content type
No sample

InsertPageNumber

Inserts page number(s) on a document.
1 token is charged per request.
Request Body schema:

A PdfInsertPageNumberParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the page or the range of pages on which the page number shall be inserted.

Format
string
Default: "PageNumber"
Enum: "PageNumber" "PagePageNumber" "PagePageNumberOfPageCount" "CustomFormatting"

Defines the different formats available for the page number insertion.

object (DrawableContentLayoutParameters)

Represents information about the layout of a content, on the page it is drawn onto.

PageNumberStartOffset
integer <int32>

Specifies the number of pages to be skipped when determining the page number value of a page. If 2 pages are to be skipped, the page number of the third page is 1 and so on. If the provided page range contains pages excluded by this parameter, no page number is inserted on those. This offset is deducted from the page count of the document.

object (PdfAlignedTextParameters)

Represents the parameters for aligned text content.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

InsertText

Inserts text on a document.
1 token is charged per request.
Request Body schema:

A PdfInsertTextParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages on which the text shall be inserted.

required
object (PdfAlignedTextParameters)

Represents the parameters for aligned text content.

DrawOnBackground
boolean
Default: false

Specifies whether the text shall be inserted in the background.

Rotation
number <float>
Default: 0

Specifies the rotation applied to the text, in degrees, clockwise.

RotationAt
string
Default: "Centered"
Enum: "TopLeft" "BottomLeft" "Centered" "Custom"

Specifies the rotation center point with respect to the bounding box of the content being added.

RotationCenterX
number <float>
Default: 0

Specifies the absolute horizontal coordinate of the rotation center from the top-left edge of the content, in points.

RotationCenterY
number <float>
Default: 0

Specifies the absolute vertical coordinate of the rotation center from the top-left edge of the content, in points.

object (DrawableContentLayoutParameters)

Represents information about the layout of a content, on the page it is drawn onto.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string",
  • "TextParameters": { }
}

Response samples

Content type
No sample

Linearize

Linearizes a previously uploaded document.
2 tokens are charged per request.
Request Body schema:

A PdfLinearizeParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PackDocument
boolean
Default: false

Specifies whether the document shall be packed, in order to reduce its size.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

LoadDocumentAsPDF

Imports the provided document as PDF. Supported document formats can be retrieved by the GetPDFImportSupportedFileExtensions action.
1 token is charged per 10 MB of the input file size.
Request Body schema:

A PdfLoadDocumentFromByteArrayParameters object specifying the parameters of the action.

Content
required
string <byte>

Specifies the data of the document.

Author
string or null
Default: ""

Specifies the author's name specified within the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

Conformance
string
Default: "PDF15"
Enum: "Unknown" "PDF10" "PDF11" "PDF12" "PDF13" "PDF14" "PDF15" "PDF16" "PDF17" "PDF20" "PDFA1a" "PDFA1b" "PDFA2a" "PDFA2u" "PDFA2b" "PDFA3a" "PDFA3u" "PDFA3b" "PDFUA1" "PDFA4" "PDFA4e" "PDFA4f"

Specifies PDF versions and conformance levels of a PDF document.

ContentEncoding
string
Default: "Identity"
Enum: "Identity" "Gzip"

Indicates the encoding mode of data.

EnableColorDetection
boolean
Default: false

Specifies whether color detection must be used while importing a raster format to PDF.

FileName
string or null

Specifies the name of the document.

GetPreview
boolean
Default: false

Specifies whether the response must contain a thumbnail of the first page of the document.

HtmlEmulationType
string
Default: "Screen"
Enum: "NoEmulation" "Print" "Screen"

Specifies how to emulates the given media type or media feature for CSS media queries.

HtmlPageHeight
number <float>
Default: 810

Specifies the page height, in points, of produced documents from html content.

HtmlPageMarginBottom
number <float>
Default: 0

Specifies the page margin bottom, in points, of produced documents from html content.

HtmlPageMarginLeft
number <float>
Default: 0

Specifies the page margin left, in points, of produced documents from html content.

HtmlPageMarginRight
number <float>
Default: 0

Specifies the page margin right, in points, of produced documents from html content.

HtmlPageMarginTop
number <float>
Default: 0

Specifies the page margin top, in points, of produced documents from html content.

HtmlPageWidth
number <float>
Default: 1440

Specifies the page width, in points, of produced documents from html content.

HtmlPreferCSSPageSize
boolean
Default: true

Specifies whether or not to prefer page size as defined by css, while producing documents from html content. When true, the paper size is adjusted to fit the content.

HtmlPreferOnePage
boolean
Default: true

Specifies whether the output document should contain a single page, while producing documents from html content.

Keywords
string or null
Default: ""

Specifies the keywords associated with the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

Metadata
string or null
Default: ""

Specifies the metadata contained within the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

Password
string or null

Specifies the password of the document.

Producer
string or null
Default: ""

Specifies the producer's name specified within the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

Subject
string or null
Default: ""

Specifies the document's subject specified within the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

ThumbnailBackgroundColor
string or null
Default: "rgba(0,0,0,0)"

Specifies the background color of the thumbnail, using the color name (ie: "red") or its RGBa code (ie: "rgba(255,0,0,1)"). Only applicable if GetPreview has been set to true.

ThumbnailFitToPageSize
boolean
Default: true

Specifies if the size of the produced thumbnail is automatically adjusted to don't have any margin. Only applicable if GetPreview has been set to true.

ThumbnailHeight
integer <int32>
Default: 220

Specifies, in pixels, the height of the thumbnail to be retrieved. Only applicable if GetPreview has been set to true.

ThumbnailWidth
integer <int32>
Default: 140

Specifies, in pixels, the width of the thumbnail to be retrieved. Only applicable if GetPreview has been set to true.

Title
string or null
Default: ""

Specifies the document's title specified within the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

TxtFontBold
boolean
Default: false

Specifies whether the font to be used for producing documents from txt files must have a bold style.

TxtFontFamily
string or null
Default: "Arial Unicode MS"

Specifies the name of the font to be used for producing documents from txt files.

TxtFontItalic
boolean
Default: false

Specifies whether the font to be used for producing documents from txt files must have an italic style.

TxtFontSize
number <float>
Default: 12

Specifies the text size, in points, to be used for producing documents from txt files.

TxtHorizontalTextAlignment
string
Default: "Near"
Enum: "Near" "Center" "Far"

Defines the different available text alignments.

TxtPageHeight
number <float>
Default: 842

Specifies the page height, in points, of produced documents from txt files.

TxtPageMarginBottom
number <float>
Default: 10

Specifies the page margin bottom, in points, of produced documents from txt files.

TxtPageMarginLeft
number <float>
Default: 10

Specifies the page margin left, in points, of produced documents from txt files.

TxtPageMarginRight
number <float>
Default: 10

Specifies the page margin right, in points, of produced documents from txt files.

TxtPageMarginTop
number <float>
Default: 10

Specifies the page margin top, in points, of produced documents from txt files.

TxtPageWidth
number <float>
Default: 595

Specifies the page width, in points, of produced documents from txt files.

Responses

Response Schema:
Encryption
string
Default: "PdfEncryptionNone"
Enum: "PdfEncryptionNone" "PdfEncryption40BitRC4" "PdfEncryption128BitRC4" "PdfEncryption128BitAES" "PdfEncryption256BitAES"

Specifies the encryption algorithm.

object (Error)

Contains all the information related to an error which has occurred.

FileId
string or null

Specifies the file identifier of the loaded document.

FileSize
integer <int64>

Specifies the size of the loaded file.

PageCount
integer <int32>

Specifies the number of pages into the loaded document.

PasswordIsRequired
boolean

Specifies if a password will be subsequently required to open the document. Password can be provided using the SetPassword action / method.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

ThumbnailData
string or null <byte>

Specifies the data of a thumbnail from the first page of the document, in PNG format. Only applicable if the GetPreview field of the request has been set to true.

Request samples

Content type
{
  • "Content": "string"
}

Response samples

Content type
No sample

LoadDocumentAsPDFFromHTTP

Imports the content stored at a specific HTTP URI as PDF. Supported document formats can be retrieved by the GetPDFImportSupportedFileExtensions action.
1 token is charged per 10 MB of the input file size.
Request Body schema:

A PdfLoadDocumentFromHTTPParameters object specifying the parameters of the action.

Uri
required
string non-empty

Specifies the URI of the file.

Author
string or null
Default: ""

Specifies the author's name specified within the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

Conformance
string
Default: "PDF15"
Enum: "Unknown" "PDF10" "PDF11" "PDF12" "PDF13" "PDF14" "PDF15" "PDF16" "PDF17" "PDF20" "PDFA1a" "PDFA1b" "PDFA2a" "PDFA2u" "PDFA2b" "PDFA3a" "PDFA3u" "PDFA3b" "PDFUA1" "PDFA4" "PDFA4e" "PDFA4f"

Specifies PDF versions and conformance levels of a PDF document.

ContentEncoding
string
Default: "Identity"
Enum: "Identity" "Gzip"

Indicates the encoding mode of data.

EnableColorDetection
boolean
Default: false

Specifies whether color detection must be used while importing a raster format to PDF.

FileName
string or null

Specifies the name of the document.

GetPreview
boolean
Default: false

Specifies whether the response must contain a thumbnail of the first page of the document.

HtmlEmulationType
string
Default: "Screen"
Enum: "NoEmulation" "Print" "Screen"

Specifies how to emulates the given media type or media feature for CSS media queries.

HtmlPageHeight
number <float>
Default: 810

Specifies the page height, in points, of produced documents from html content.

HtmlPageMarginBottom
number <float>
Default: 0

Specifies the page margin bottom, in points, of produced documents from html content.

HtmlPageMarginLeft
number <float>
Default: 0

Specifies the page margin left, in points, of produced documents from html content.

HtmlPageMarginRight
number <float>
Default: 0

Specifies the page margin right, in points, of produced documents from html content.

HtmlPageMarginTop
number <float>
Default: 0

Specifies the page margin top, in points, of produced documents from html content.

HtmlPageWidth
number <float>
Default: 1440

Specifies the page width, in points, of produced documents from html content.

HtmlPreferCSSPageSize
boolean
Default: true

Specifies whether or not to prefer page size as defined by css, while producing documents from html content. When true, the paper size is adjusted to fit the content.

HtmlPreferOnePage
boolean
Default: true

Specifies whether the output document should contain a single page, while producing documents from html content.

Keywords
string or null
Default: ""

Specifies the keywords associated with the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

Metadata
string or null
Default: ""

Specifies the metadata contained within the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

Password
string or null

Specifies the password of the document.

Producer
string or null
Default: ""

Specifies the producer's name specified within the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

Subject
string or null
Default: ""

Specifies the document's subject specified within the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

ThumbnailBackgroundColor
string or null
Default: "rgba(0,0,0,0)"

Specifies the background color of the thumbnail, using the color name (ie: "red") or its RGBa code (ie: "rgba(255,0,0,1)"). Only applicable if GetPreview has been set to true.

ThumbnailFitToPageSize
boolean
Default: true

Specifies if the size of the produced thumbnail is automatically adjusted to don't have any margin. Only applicable if GetPreview has been set to true.

ThumbnailHeight
integer <int32>
Default: 220

Specifies, in pixels, the height of the thumbnail to be retrieved. Only applicable if GetPreview has been set to true.

ThumbnailWidth
integer <int32>
Default: 140

Specifies, in pixels, the width of the thumbnail to be retrieved. Only applicable if GetPreview has been set to true.

Title
string or null
Default: ""

Specifies the document's title specified within the PDF to generate, if any. This value will be used only if the provided file is not a PDF document.

TxtFontBold
boolean
Default: false

Specifies whether the font to be used for producing documents from txt files must have a bold style.

TxtFontFamily
string or null
Default: "Arial Unicode MS"

Specifies the name of the font to be used for producing documents from txt files.

TxtFontItalic
boolean
Default: false

Specifies whether the font to be used for producing documents from txt files must have an italic style.

TxtFontSize
number <float>
Default: 12

Specifies the text size, in points, to be used for producing documents from txt files.

TxtHorizontalTextAlignment
string
Default: "Near"
Enum: "Near" "Center" "Far"

Defines the different available text alignments.

TxtPageHeight
number <float>
Default: 842

Specifies the page height, in points, of produced documents from txt files.

TxtPageMarginBottom
number <float>
Default: 10

Specifies the page margin bottom, in points, of produced documents from txt files.

TxtPageMarginLeft
number <float>
Default: 10

Specifies the page margin left, in points, of produced documents from txt files.

TxtPageMarginRight
number <float>
Default: 10

Specifies the page margin right, in points, of produced documents from txt files.

TxtPageMarginTop
number <float>
Default: 10

Specifies the page margin top, in points, of produced documents from txt files.

TxtPageWidth
number <float>
Default: 595

Specifies the page width, in points, of produced documents from txt files.

Responses

Response Schema:
Encryption
string
Default: "PdfEncryptionNone"
Enum: "PdfEncryptionNone" "PdfEncryption40BitRC4" "PdfEncryption128BitRC4" "PdfEncryption128BitAES" "PdfEncryption256BitAES"

Specifies the encryption algorithm.

object (Error)

Contains all the information related to an error which has occurred.

FileId
string or null

Specifies the file identifier of the loaded document.

FileSize
integer <int64>

Specifies the size of the loaded file.

PageCount
integer <int32>

Specifies the number of pages into the loaded document.

PasswordIsRequired
boolean

Specifies if a password will be subsequently required to open the document. Password can be provided using the SetPassword action / method.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

ThumbnailData
string or null <byte>

Specifies the data of a thumbnail from the first page of the document, in PNG format. Only applicable if the GetPreview field of the request has been set to true.

Request samples

Content type
{
  • "Uri": "string"
}

Response samples

Content type
No sample

LoadDocumentAsPDFMultipart

Imports the provided document as PDF using Multipart Upload. Supported document formats can be retrieved by the GetPDFImportSupportedFileExtensions action.
1 token is charged per 10 MB of the input file size.
Request Body schema: multipart/form-data
fileData
required
string <binary>
object (PdfLoadDocumentParameters)

Represents the parameters for importing a document as PDF.

Responses

Response Schema:
Encryption
string
Default: "PdfEncryptionNone"
Enum: "PdfEncryptionNone" "PdfEncryption40BitRC4" "PdfEncryption128BitRC4" "PdfEncryption128BitAES" "PdfEncryption256BitAES"

Specifies the encryption algorithm.

object (Error)

Contains all the information related to an error which has occurred.

FileId
string or null

Specifies the file identifier of the loaded document.

FileSize
integer <int64>

Specifies the size of the loaded file.

PageCount
integer <int32>

Specifies the number of pages into the loaded document.

PasswordIsRequired
boolean

Specifies if a password will be subsequently required to open the document. Password can be provided using the SetPassword action / method.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

ThumbnailData
string or null <byte>

Specifies the data of a thumbnail from the first page of the document, in PNG format. Only applicable if the GetPreview field of the request has been set to true.

Response samples

Content type
No sample

Merge

Merges several previously uploaded documents into a new PDF.
5 tokens are charged per request.
Request Body schema:

A PdfMergeParameters object specifying the parameters of the action.

FilesId
required
Array of strings

Specifies the identifiers of the documents to be merged.

IncludeAttachments
boolean
Default: true

Specifies if file attachments should be included in merged document.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

FileId
string or null

Specifies the file identifier of the merged document.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FilesId": [
    ]
}

Response samples

Content type
No sample

MergePages

Merges multiple pages, vertically, within a previously uploaded document into one single page.
1 token is charged per request.
Request Body schema:

A PdfMergePages object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the range of pages to be combined.

RemovePages
boolean

Specifies whether the merged pages shall be removed from the document.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

MovePage

Moves a page range from a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfMovePageParameters object specifying the parameters of the action.

DestinationPage
required
integer <int32>

Specifies the number of the destination page. If a value inferior to 0 or greater than the total number of page of the PDF is provided, the page(s) shall be inserted respectively at the beginning or the end of the PDF.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

SourcePageRange
required
string non-empty

Specifies the number of the page, or the range of pages to be moved.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "SourcePageRange": "string",
  • "DestinationPage": 0
}

Response samples

Content type
No sample

OCR

Performs optical character recognition on a page range of a previously uploaded document. The recognized text is added as invisible text on each processed page. No token is charged for blank pages.
12 tokens are charged per page.
Request Body schema:

A PdfOCRParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the page or the page range to be processed.

Language
string or null
Default: "eng"

Specifies the language to be used for the OCR. Supported values are:

  • "deu" for German.
  • "eng" for English.
  • "fra" for French.
  • "ita" for Italian.
  • "por" for Portuguese.
  • "spa" for Spanish.
  • "jpn" for Japanese.
SkipPageWithText
boolean
Default: true

Specifies if pages containing text must be ignored (in such case no token is charged).

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

Protect

Protects a previously uploaded document.
2 tokens are charged per request.
Request Body schema:

A PdfProtectParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

CanAddNotes
boolean
Default: true

Allows the user to add annotations. Ignored if no encryption scheme is set.

CanAssemble
boolean
Default: true

Allows the user to assemble the document. Only works with AES encryption algorithms.

CanCopy
boolean
Default: true

Allows the user to copy or extract text and graphics from the document. Ignored if no encryption algorithm is set.

CanCopyAccess
boolean
Default: true

Enables copying or extracting for use with accessibility features. Only works with AES encryption algorithms.

CanFillFields
boolean
Default: true

Allows the user to fill-in form fields. Only works with AES encryption algorithms.

CanModify
boolean
Default: true

Allows the user to modify the document. Ignored if no encryption scheme is set.

CanPrint
boolean
Default: true

Allows the user to print the document, but possibly not at the highest quality level. Ignored if no encryption algorithm is set.

CanPrintFull
boolean
Default: true

Allows high resolution printing of the document. Only works with AES encryption algorithms.

Encryption
string
Default: "PdfEncryption256BitAES"
Enum: "PdfEncryptionNone" "PdfEncryption40BitRC4" "PdfEncryption128BitRC4" "PdfEncryption128BitAES" "PdfEncryption256BitAES"

Specifies the encryption algorithm.

OwnerPassword
string or null
Default: ""

Specifies the owner password to be set.

UserPassword
string or null
Default: ""

Specifies the user password to be set.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ReadBarcodes

Reads barcodes from a previously uploaded document.
2 tokens are charged per page.
Request Body schema:

A PdfReadBarcodesParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to read the barcodes from.

FollowPageRotation
boolean
Default: false

Specifies whether the coordinates of detected barcodes are following the page's rotation, if any.

ScanBarcode1D
boolean
Default: true

Specifies whether the barcodes of type 1D shall be read.

ScanBarcodeAztec
boolean
Default: true

Specifies whether the barcodes of type Aztec shall be read.

ScanBarcodeDataMatrix
boolean
Default: true

Specifies whether the barcodes of type Data Matrix shall be read.

ScanBarcodeMaxiCode
boolean
Default: true

Specifies whether the barcodes of type MaxiCode shall be read.

ScanBarcodeMicroQR
boolean
Default: true

Specifies whether the barcodes of type Micro QR shall be read.

ScanBarcodePDF417
boolean
Default: true

Specifies whether the barcodes of type PDF 147 shall be read.

ScanBarcodeQR
boolean
Default: true

Specifies whether the barcodes of type QR shall be read.

ScanMode
string
Default: "FavorAccuracy"
Enum: "FavorSpeed" "FavorAccuracy"

Defines the different available scan modes.

Responses

Response Schema:
Array of objects or null (BarcodeInfo)

Specifies the information of the different barcodes which have been read.

object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

Redact

Redacts a previously uploaded document.
5 tokens are charged per page.
Request Body schema:

A PdfRedactParameters object specifying the regions to redact.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

required
Array of objects (PdfRedactRegion)

Specifies the list of the regions to redact.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "Regions": [
    ]
}

Response samples

Content type
No sample

Reduce

Reduces the size of a previously uploaded document.
5 tokens are charged per request.If MRC compression is enabled 4 additional tokens per MRC encoded image will be charged.
Request Body schema:

A PdfReduceParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

DownscaleImages
boolean
Default: true

Specifies whether the images from the PDF shall be downscaled.

DownscaleResolution
integer <int32>
Default: 150

Specifies the resolution to be used to downscale images.

DownscaleResolutionMRC
integer <int32>
Default: 100

Specifies the resolution for downscaling the background layer by the MRC engine, if any.

EnableCharRepair
boolean
Default: false

Specifies whether characters repairing shall be performed during bitonal conversion.

EnableColorDetection
boolean
Default: true

Specifies whether color detection must be performed on the images from the PDF.

EnableJBIG2
boolean
Default: true

Specifies whether the JBIG2 compression scheme shall be used to compress the bitonal images of the PDF.

EnableJPEG2000
boolean
Default: true

Specifies whether the JPEG2000 compression scheme shall be used to compress the images of the PDF.

EnableMRC
boolean
Default: false

Specifies whether MRC shall be used for compressing the PDF contents.

FastWebView
boolean
Default: false

Specifies whether the PDF shall be optimized for online distribution.

ImageQuality
string
Default: "ImageQualityMedium"
Enum: "ImageQualityVeryLow" "ImageQualityLow" "ImageQualityMedium" "ImageQualityHigh" "ImageQualityVeryHigh" "ImageQualityVeryVeryHigh"

Specifies the quality to be used for the compression of the images of the document.

JBIG2PMSThreshold
number <float>
Default: 0.85

Specifies the threshold value for the JBIG2 encoder pattern matching and substitution between 0.4 and 1. Any number lower than 1 may lead to lossy compression.

OutputVersion
string
Default: "PdfVersion15"
Enum: "PdfVersionRetainExisting" "PdfVersion14" "PdfVersion15" "PdfVersion16" "PdfVersion17" "PdfVersionA1a" "PdfVersionA1b" "PdfVersionA2a" "PdfVersionA2b" "PdfVersionA2u" "PdfVersionA3a" "PdfVersionA3b" "PdfVersionA3u" "PdfVersion20" "PdfVersionA4" "PdfVersionA4e" "PdfVersionA4f"

Specifies a PDF version for a reduced document.

PackDocument
boolean
Default: true

Specifies whether the PDF shall be packed when saved in order to reduce its size.

PackFonts
boolean
Default: true

Specifies whether the PDF fonts must be packed in order to reduce their size.

PreserveSmoothing
boolean
Default: false

Specifies if the MRC engine shall try to preserve smoothing between different layers.

RecompressImages
boolean
Default: true

Specifies whether the images from the PDF shall be recompressed.

RemoveAnnotations
boolean
Default: false

Specifies whether the annotations shall be removed from the PDF.

RemoveBlankPages
boolean
Default: false

Specifies whether the blank pages shall be removed.

RemoveBookmarks
boolean
Default: false

Specifies whether the bookmarks shall be removed from the PDF.

RemoveEmbeddedFiles
boolean
Default: false

Specifies whether the embedded files shall be removed from the PDF.

RemoveEmbeddedFonts
boolean
Default: false

Specifies whether the embedded fonts shall be removed from the PDF.

RemoveFormFields
boolean
Default: false

Specifies whether the form fields shall be removed from the PDF.

RemoveHyperlinks
boolean
Default: false

Specifies whether the hyperlinks shall be removed from the PDF.

RemoveJavaScript
boolean
Default: false

Specifies whether the JavaScript shall be removed.

RemoveMetadata
boolean
Default: false

Specifies whether the metadata shall be removed.

RemovePagePieceInfo
boolean
Default: false

Specifies whether the page PieceInfo dictionary used to hold private application data shall be removed.

RemovePageThumbnails
boolean
Default: false

Specifies whether the page thumbnails shall be removed.

Responses

Response Schema:
ContentRemoved
boolean

Specifies whether content has been removed from the PDF during the process of the reduce action.

object (Error)

Contains all the information related to an error which has occurred.

object (ReduceErrorInfo)

Represents information about an error which caused the failure of a reduce action.

NewFileSize
integer <int64>

Specify the size of the new created document.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

VersionChanged
boolean

Specifies whether the version of the PDF has changed during the process of the reduce action.

Array of objects or null (ReduceWarningInfo)

Specifies the different warnings that occurred during the process of the reduce action.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

RemovePageFormFields

Removes the form fields from a page range of a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfRemovePageFormFieldsParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the page or the page range whose form fields shall be removed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

RemoveText

Removes text (all text or only invisible one) from a previously uploaded PDF.
2 tokens are charged per request.
Request Body schema:

A PdfRemoveTextParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the page or the page range whose text shall be removed.

RemoveOnlyHiddenText
boolean
Default: false

Specifies whether only hidden text shall be removed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string"
}

Response samples

Content type
No sample

ReorderPages

Reorders pages of a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfReorderPagesParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageOrder
required
string non-empty

Specifies the new pages order. Must contains page numbers separated by ';' or ','. Example for a 6-pages document: "1;2;4;3;6;5".

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageOrder": "string"
}

Response samples

Content type
No sample

RepairDocument

Repairs a previously uploaded PDF document.
2 tokens are charged per request.
Request Body schema:

A PdfRepairDocumentParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

FileId
string or null

Specifies the file identifier of the repaired document.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

RotatePageStandard

Rotates (standardly) a page range from a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfRotatePageStandardParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages to be rotated. You can specify different page rotations using such pattern: Page Range = "M:1:90;2:270". In this example, a rotation of 90 degrees will be applied to the page 1 and 270 degrees to the page 2.

RotationAngle
required
integer <int32>

Specifies the rotation angle, clockwise in degrees, which can be either positive and negative and any multiple of 90. Use 0 in case of special pattern usage for the PageRange property.

FlipHorizontally
boolean
Default: false

Specifies whether the page(s) shall be flipped horizontally. This parameter is ignored if PageRange start with "M:".

FlipVertically
boolean
Default: false

Specifies whether the page(s) shall be flipped vertically. This parameter is ignored if PageRange start with "M:".

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string",
  • "RotationAngle": 0
}

Response samples

Content type
No sample

PdfSaveAsDOCXResponse

Saves a previously uploaded document as DOCX, and sends the file data in a JSON-serialized object.
2 tokens are charged per page.
Request Body schema:

A PdfSaveAsDOCXParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as DOCX.

Responses

Response Schema:
Data
string or null <byte>

Specifies the data of the saved document.

object (Error)

Contains all the information related to an error which has occurred.

FileName
string or null

Specifies the name of the saved document.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveAsDOCXFile

Saves a previously uploaded document as DOCX, and streams the file binary data to the response (this is the most efficient download method).
2 tokens are charged per page.
Request Body schema:

A PdfSaveAsDOCXParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as DOCX.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveAsJPEG

Saves a previously uploaded document as JPEG, and sends the file data in a JSON-serialized object.
1 token is charged per page.
Request Body schema:

A PdfSaveAsJPEGParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

JPEGSubsamplingMode
string
Default: "Default"
Enum: "Default" "Y4Cb1Cr1" "Y4Cb2Cr0" "Y4Cb2Cr2" "Y4Cb4Cr4"

Specifies the different available chroma subsampling mode for image compression in JPEG images.

KeepRasterPDFResolution
boolean
Default: true

Specifies if the initial image resolution must be kept in case of raster-pdf processing.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as JPEG.

Progressive
boolean
Default: false

Specifies if the encoded JPEG image must be progressive.

Quality
integer <int32>
Default: 75

Specifies the level of quality to be used for the JPEG compression, from 1 (poorest) to 100 (greatest).

RenderFormFields
boolean
Default: false

Specifies whether the form fields of the PDF shall be rendered.

Resolution
number <float>
Default: 200

Specifies the resolution to be used for the rendition process.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageImage)

The page(s) of the PDF saved as JPEG image(s).

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveAsJPEGFile

Saves a previously uploaded document as JPEG, and streams the file binary data to the response (this is the most efficient download method).
1 token is charged per page.
Request Body schema:

A PdfSaveAsJPEGParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

JPEGSubsamplingMode
string
Default: "Default"
Enum: "Default" "Y4Cb1Cr1" "Y4Cb2Cr0" "Y4Cb2Cr2" "Y4Cb4Cr4"

Specifies the different available chroma subsampling mode for image compression in JPEG images.

KeepRasterPDFResolution
boolean
Default: true

Specifies if the initial image resolution must be kept in case of raster-pdf processing.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as JPEG.

Progressive
boolean
Default: false

Specifies if the encoded JPEG image must be progressive.

Quality
integer <int32>
Default: 75

Specifies the level of quality to be used for the JPEG compression, from 1 (poorest) to 100 (greatest).

RenderFormFields
boolean
Default: false

Specifies whether the form fields of the PDF shall be rendered.

Resolution
number <float>
Default: 200

Specifies the resolution to be used for the rendition process.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveAsPNG

Saves a previously uploaded document as PNG, and sends the file data in a JSON-serialized object.
1 token is charged per page.
Request Body schema:

A PdfSaveAsPNGParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
integer <int32>
Default: 6

Specifies the level of compression to be used for the PNG output, between 0 (no compression - faster encoding) to 9(max compression - slower encoding).

Interlaced
boolean
Default: false

Specifies if the produced PNG image must be interlaced.

KeepRasterPDFResolution
boolean
Default: true

Specifies if the initial image resolution must be kept in case of raster-pdf processing.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as PNG.

RenderFormFields
boolean
Default: false

Specifies whether the form fields of the PDF shall be rendered.

Resolution
number <float>
Default: 200

Specifies the resolution to be used for the rendition process.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageImage)

The page(s) of the PDF saved as PNG image(s).

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveAsPNGFile

Saves a previously uploaded document as PNG, and streams the file binary data to the response (this is the most efficient download method).
1 token is charged per page.
Request Body schema:

A PdfSaveAsPNGParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
integer <int32>
Default: 6

Specifies the level of compression to be used for the PNG output, between 0 (no compression - faster encoding) to 9(max compression - slower encoding).

Interlaced
boolean
Default: false

Specifies if the produced PNG image must be interlaced.

KeepRasterPDFResolution
boolean
Default: true

Specifies if the initial image resolution must be kept in case of raster-pdf processing.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as PNG.

RenderFormFields
boolean
Default: false

Specifies whether the form fields of the PDF shall be rendered.

Resolution
number <float>
Default: 200

Specifies the resolution to be used for the rendition process.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

PdfSaveAsPPTXResponse

Saves a previously uploaded document as PPTX, and sends the file data in a JSON-serialized object.
2 tokens are charged per page.
Request Body schema:

A PdfSaveAsPPTXParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as PPTX.

Responses

Response Schema:
Data
string or null <byte>

Specifies the data of the saved document.

object (Error)

Contains all the information related to an error which has occurred.

FileName
string or null

Specifies the name of the saved document.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveAsPPTXFile

Saves a previously uploaded document as PPTX, and streams the file binary data to the response (this is the most efficient download method).
2 tokens are charged per page.
Request Body schema:

A PdfSaveAsPPTXParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as PPTX.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveAsTIFF

Saves a previously uploaded document as TIFF, and sends the file data in a JSON-serialized object.
1 token is charged per page.
Request Body schema:

A PdfSaveAsTIFFParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
string
Default: "Auto"
Enum: "Deflate" "CCITT3" "CCITT4" "LZW" "JPEG" "RLE" "Auto"

Specifies the TIFF compression when saving images in TIFF format.

JpegQuality
integer <int32>
Default: 75

Specifies the level of quality to be used if JPEG compression is used, from 1 (poorest) to 100 (greatest).

KeepRasterPDFResolution
boolean
Default: true

Specifies whether the initial image resolution must be kept in case of raster-pdf processing.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as TIFF.

RenderFormFields
boolean
Default: false

Specifies whether the form fields of the PDF shall be rendered.

Resolution
number <float>
Default: 200

Specifies the resolution to be used for the rendition process.

UseCMYK
boolean
Default: false

Specifies whether the TIFF shall be saved in CMYK color space or not.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

Array of objects or null (PageImage)

The page(s) of the PDF saved as TIFF image(s).

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveAsTIFFFile

Saves a previously uploaded document as TIFF, and streams the file binary data to the response (this is the most efficient download method).
1 token is charged per page.
Request Body schema:

A PdfSaveAsTIFFParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
string
Default: "Auto"
Enum: "Deflate" "CCITT3" "CCITT4" "LZW" "JPEG" "RLE" "Auto"

Specifies the TIFF compression when saving images in TIFF format.

JpegQuality
integer <int32>
Default: 75

Specifies the level of quality to be used if JPEG compression is used, from 1 (poorest) to 100 (greatest).

KeepRasterPDFResolution
boolean
Default: true

Specifies whether the initial image resolution must be kept in case of raster-pdf processing.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as TIFF.

RenderFormFields
boolean
Default: false

Specifies whether the form fields of the PDF shall be rendered.

Resolution
number <float>
Default: 200

Specifies the resolution to be used for the rendition process.

UseCMYK
boolean
Default: false

Specifies whether the TIFF shall be saved in CMYK color space or not.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveAsTIFFMultipage

Saves a previously uploaded document as multipage TIFF, and sends the file data in a JSON-serialized object.
1 token is charged per page.
Request Body schema:

A PdfSaveAsTIFFMultipageParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
string
Default: "Auto"
Enum: "Deflate" "CCITT3" "CCITT4" "LZW" "JPEG" "RLE" "Auto"

Specifies the TIFF compression when saving images in TIFF format.

JpegQuality
integer <int32>
Default: 75

Specifies the level of quality to be used if JPEG compression is used, from 1 (poorest) to 100 (greatest).

KeepRasterPDFResolution
boolean
Default: true

Specifies whether the initial image resolution must be kept in case of raster-pdf processing.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as TIFF.

RenderFormFields
boolean
Default: false

Specifies whether the form fields of the PDF shall be rendered.

Resolution
number <float>
Default: 200

Specifies the resolution to be used for the rendition process.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

FileName
string or null

Specifies the name of the saved document.

ImageData
string or null <byte>

Specifies the data of the produced multipage TIFF.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveAsTIFFMultipageFile

Saves a previously uploaded document as multipage TIFF, and streams the file binary data to the response (this is the most efficient download method).
1 token is charged per page.
Request Body schema:

A PdfSaveAsTIFFMultipageParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Compression
string
Default: "Auto"
Enum: "Deflate" "CCITT3" "CCITT4" "LZW" "JPEG" "RLE" "Auto"

Specifies the TIFF compression when saving images in TIFF format.

JpegQuality
integer <int32>
Default: 75

Specifies the level of quality to be used if JPEG compression is used, from 1 (poorest) to 100 (greatest).

KeepRasterPDFResolution
boolean
Default: true

Specifies whether the initial image resolution must be kept in case of raster-pdf processing.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as TIFF.

RenderFormFields
boolean
Default: false

Specifies whether the form fields of the PDF shall be rendered.

Resolution
number <float>
Default: 200

Specifies the resolution to be used for the rendition process.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

PdfSaveAsXLSXResponse

Saves a previously uploaded document as XLSX, and sends the file data in a JSON-serialized object.
2 tokens are charged per page.
Request Body schema:

A PdfSaveAsXLSXParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as XLSX.

Responses

Response Schema:
Data
string or null <byte>

Specifies the data of the saved document.

object (Error)

Contains all the information related to an error which has occurred.

FileName
string or null

Specifies the name of the saved document.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveAsXLSXFile

Saves a previously uploaded document as XLSX, and streams the file binary data to the response (this is the most efficient download method).
2 tokens are charged per page.
Request Body schema:

A PdfSaveAsXLSXParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
string or null
Default: "*"

Specifies the number of the page, or the range of pages to be saved as XLSX.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveDocument

Saves a previously uploaded document as PDF, and sends the file data in a JSON-serialized object.
1 token is charged per request.
Request Body schema:

A PdfSaveDocumentParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Responses

Response Schema:
Data
string or null <byte>

Specifies the data of the saved document.

object (Error)

Contains all the information related to an error which has occurred.

FileName
string or null

Specifies the name of the saved document.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SaveDocumentToFile

Saves a previously uploaded document as PDF, and streams the file binary data to the response (this is the most efficient download method).
1 token is charged per request.
Request Body schema:

A PdfSaveDocumentParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Responses

Response Schema:
string <binary>

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

ScalePage

Scales a page range from a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfScalePage object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

PageRange
required
string non-empty

Specifies the number of the page, or the range of pages which shall be scaled.

ScaleX
required
number <float>

Specifies the horizontal scale factor, by which the width of the page shall be multiplied. For example, if the factor is 2, page width is multiplied by 2. If the factor is 0.5, page width is divided by 2.

ScaleY
required
number <float>

Specifies the horizontal scale factor, by which the height of the page shall be multiplied. For example, if the factor is 2, page height is multiplied by 2. If the factor is 0.5, page height is divided by 2.

FollowPageRotation
boolean
Default: false

Specifies whether scaling should take into account the page's rotation, if any.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string",
  • "ScaleX": 0,
  • "ScaleY": 0
}

Response samples

Content type
No sample

SetInfo

Sets information to a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfSetInfoParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Author
string or null
Default: ""

Specifies the author name specified within the PDF, if any.

ClearEmptyValues
boolean
Default: false

Specifies whether the empty info values shall be cleared.

Keywords
string or null
Default: ""

Specifies the keywords associated with the PDF, if any.

Metadata
string or null
Default: ""

Specifies the metadata contained within the PDF, if any.

Producer
string or null
Default: ""

Specifies the producer name specified within the PDF, if any.

Subject
string or null
Default: ""

Specifies the document subject specified within the PDF, if any.

Title
string or null
Default: ""

Specifies the document title specified within the PDF, if any.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SetInitialView

Sets various document level initial view options to a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfsetInitialViewParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

CenterWindow
boolean
Default: false

(Optional) A flag specifying whether to position the document’s window in the center of the screen. Default value: false.

DisplayDocTitle
boolean
Default: false

(Optional; PDF 1.4) A flag specifying whether the window’s title bar should display the document title taken from the Title entry of the document information dictionary. If false, the title bar should instead display the name of the PDF file containing the document. Default value: false.

FitWindow
boolean
Default: false

(Optional) A flag specifying whether to resize the document’s window to fit the size of the first displayed page. Default value: false.

HideMenubar
boolean
Default: false

(Optional) A flag specifying whether to hide the viewer application’s menu bar when the document is active. Default value: false.

HideToolbar
boolean
Default: false

A flag specifying whether to hide the viewer application’s tool bars when the document is active. Default value: false.

HideWindowUI
boolean
Default: false

(Optional) A flag specifying whether to hide user interface elements in the document’s window (such as scroll bars and navigation controls), leaving only the document’s contents displayed. Default value: false.

LayoutMode
string
Default: "SinglePage"
Enum: "SinglePage" "OneColumn" "TwoColumnLeft" "TwoColumnRight" "TwoPageLeft" "TwoPageRight"

Specifies the page layout to be used when the document is opened.

NonFullScreenPageMode
string
Default: "None"
Enum: "None" "Outline" "Thumbnails" "OC"

Defines how the document shall be displayed when exiting full-screen mode.

OpenPage
integer <int32>
Default: 1

Specifies which page should be displayed when the document is opened.

OpenZoom
number <float>
Default: 1

Specifies the default zoom factor to be used when the document is opened. Value of 1 to represent the 100% zoom, 2 means 200%, 0,5 means 50%, etc.

PageMode
string
Default: "None"
Enum: "None" "Outline" "Thumbnails" "FullScreen" "OC" "Attachments"

Defines how the document shall be displayed when opened.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample

SetMetadata

Sets the metadata of a previously uploaded PDF.
1 token is charged per request.
Request Body schema:

A PdfSetMetadataParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of a previously uploaded file.

Metadata
required
string non-empty

The value of the document's metadata as a string in the XMP standardized format.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "Metadata": "string"
}

Response samples

Content type
No sample

SetPageBox

Sets pagebox to a page range from previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfSetPageBoxParameters object specifying the parameters of the action.

Bottom
required
number <float>

Specifies, in points, the newly defined bottom position of the specified page box. The location of the coordinate system origin used is bottom-left.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Left
required
number <float>

Specifies, in points, the newly defined left position of the specified page box. The location of the coordinate system origin used is bottom-left.

PageRange
required
string non-empty

Specifies the number of the page, or the range of page whose page box shall be set.

Right
required
number <float>

Specifies, in points, the newly defined right position of the specified page box. The location of the coordinate system origin used is bottom-left.

Top
required
number <float>

Specifies, in points, the newly defined top position of the specified page box. The location of the coordinate system origin used is bottom-left.

PageBox
string
Default: "CropBox"
Enum: "MediaBox" "CropBox" "BleedBox" "TrimBox" "ArtBox"

Defines the boundary boxes (page boxes) that relate to the size of the pages in the PDF document.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "PageRange": "string",
  • "Left": 0,
  • "Top": 0,
  • "Right": 0,
  • "Bottom": 0
}

Response samples

Content type
No sample

SetPassword

Unprotects a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfSetPasswordParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Password
required
string non-empty

Specifies the password to be used to open the PDF. It can be the user or the owner password.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "Password": "string"
}

Response samples

Content type
No sample

Split

Splits a previously uploaded document into new ones.
5 tokens are charged per request.
Request Body schema:

A PdfSplitParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

SplitMethod
required
string
Default: "SplitByNumberOfPages"
Enum: "SplitByNumberOfPages" "SplitByFileSize" "SplitByTopLevelBookmarks"

Defines the different available methods for splitting a PDF.

SplitValue
required
integer <int32>

Specifies, respectively for the SplitByPageCount and SplitByFileSize split methods, the number of pages or the maximum size, in kilobytes, of the produced files. The SplitByTopLevelBookmarks split method does not make use of this parameter.

ImmediateDownload
boolean
Default: false

Specifies whether the file(s) created as a result of the action shall be available for immediate download.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

FileData
Array of strings or null <byte>

Specifies the data of the file(s) created as a result of the action. If immediate download is not requested, no file data will be returned.

FileIds
Array of strings or null

Specifies the identifier(s) of the file(s) created as a result of the action. If immediate download is requested, no file identifier will be returned.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "SplitMethod": "SplitByNumberOfPages",
  • "SplitValue": 0
}

Response samples

Content type
No sample

SwapPages

Swaps two pages from a previously uploaded document.
1 token is charged per request.
Request Body schema:

A PdfSwapPagesParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Page1
required
integer <int32>

Specifies the number of the first page.

Page2
required
integer <int32>

Specifies the number of the second page.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "Page1": 0,
  • "Page2": 0
}

Response samples

Content type
No sample

Unprotect

Unprotects a previously uploaded document.
2 tokens are charged per request.
Request Body schema:

A PdfUnprotectParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of the previously uploaded file to be processed.

Password
required
string non-empty

Specifies the password to be used to unprotect the PDF. The owner password is required in order to unprotect the PDF.

Responses

Response Schema:
object (Error)

Contains all the information related to an error which has occurred.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string",
  • "Password": "string"
}

Response samples

Content type
No sample

ValidatePDFA

Validates a previously uploaded document to a requested PDF/A standard.
5 tokens are charged per request.
Request Body schema:

A PdfValidatePDFAParameters object specifying the parameters of the action.

FileId
required
string non-empty

The identifier of a previously uploaded file.

Conformance
string
Default: "Autodetect"
Enum: "Autodetect" "PDFA1a" "PDFA1b" "PDFA2a" "PDFA2b" "PDFA2u" "PDFA3a" "PDFA3b" "PDFA3u" "PDFA4" "PDFA4e" "PDFA4f"

Specifies the different available PDF/A conformance levels for validation.

Responses

Response Schema:
Conformance
string
Default: "Autodetect"
Enum: "Autodetect" "PDFA1a" "PDFA1b" "PDFA2a" "PDFA2b" "PDFA2u" "PDFA3a" "PDFA3b" "PDFA3u" "PDFA4" "PDFA4e" "PDFA4f"

Specifies the different available PDF/A conformance levels for validation.

DetailedXMLOutput
string or null

Provides a detailed validation result in machine readable XML report. If the file does not conform to the requested standard, the XML report will summarize all the problems found during the validation process.

object (Error)

Contains all the information related to an error which has occurred.

IsValid
boolean

Provides a simple validation result; true if the document conforms to the requested standard, false otherwise.

RemainingTokens
integer <int64>

Specifies the number of remaining tokens.

Request samples

Content type
{
  • "FileId": "string"
}

Response samples

Content type
No sample