Skip to main content
A completed splitting job returns one entry per split file in result.files, each with a download URL and a confidence score for the classification. The example below is a real response from splitting a bundle of pages from a mutual fund annual report that contained a fund performance summary, a schedule of investments, and a financial statement.

​
Top-Level Fields

  • job_id: unique identifier for the split job
  • status: job state. queued while the job waits to be picked up, processing while it runs, then completed or failed.
  • progress: human-readable progress message
  • error: error message if the job failed, otherwise null
  • file_url: presigned download URL for the original uploaded file. Expires roughly an hour after the response is generated. Re-issue GET /splitter/{job_id} to get a fresh URL.
  • file_name: name of the original file
  • parameters: echo of the parameters used for this job (described below)
  • result: the split files (described below)

​
Parameters Object

The parameters block echoes the inputs used for the split, including defaults applied by the API.
  • classes: the category names you submitted
  • page_count: number of pages in the uploaded document
  • enable_reordering: whether the splitter reordered pages within each category after classification. Only applied to categories with more than one matched page. Defaults to false.
  • category_descriptions: the descriptions you submitted for each category

​
Result Object

  • success: whether the split operation succeeded
  • message: human-readable success or failure message
  • files: array of generated split files, one per matched category. Pages sharing a category are grouped into a single file, so a bundle with several schedule-of-investments pages yields one Schedule of Investments.pdf containing all of them.

​
File Object

Each entry in result.files represents one split document.
  • name: name of the split file, derived from the matched category
  • path: relative path to the file
  • type: file type, always "file"
  • fileId: unique identifier for the file
  • full_path: presigned download URL for the split file. Expires roughly an hour after the response is generated, so download or copy the file straight away rather than storing the URL. To get a fresh URL, re-issue GET /splitter/{job_id}.
  • confidence_score: classification confidence for this file (0–1), averaged across all pages assigned to the category
For the full request and response specification, see the Split API reference.