The Split at Mark operation separates a PDF into multiple documents based on marks identified by pdfToolbox checks.

Use this operation to automatically split combined PDF files into individual documents without manual intervention.

When to use

Use the Split at Mark operation when document boundaries can be identified by specific marks, separator pages, or other content recognized by a pdfToolbox check.

Typical use cases include:

• Split combined print jobs into individual documents.
• Separate batches of scanned or imported documents.
• Process production files containing separator marks.
• Automate document extraction in prepress workflows.

Endpoint

Submit a POST request to the Split at Mark endpoint.

The operation follows the common asynchronous processing model described in the Overview.

Request

A request consists of:

• one or more input PDF files,
• the check or profile used to identify document boundaries,
• optional processing and output parameters.

During processing, pdfToolbox analyzes the document and creates a new PDF whenever the configured split condition is met.

Response

After processing has completed, the operation returns one or more PDF documents created from the original input file.

The number of output documents depends on the number of detected split marks.

If no valid split marks are found, the operation returns the corresponding processing result or error information.

Typical workflow

A common workflow is:

1. Submit the PDF document.
2. Specify the check or profile used to detect split marks.
3. Wait for processing to complete.
4. Download the generated PDF documents.