---
title: "Run a published page-range splitter on a stored document"
method: POST
path: "/splitters/{id}/run"
tags: ["Splitters"]
---

# Run a published page-range splitter on a stored document

`POST /splitters/{id}/run`

## Request

- Base URL: `https://api.pdfparse.net/v1`
- URL: `https://api.pdfparse.net/v1/splitters/{id}/run`
- Auth: HTTP bearer

Persist immutable document segments and queued destination work items. Unassigned pages pause the processing run for human review.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string: Scopes replay protection to the authenticated project, method, and route for 24 hours.

## Request body

- object
  - `document_id` integer, required
  - `version` integer

## Response `201`

Created

- object
  - `processing_run_id` string, required
  - `split_run_id` string, required
  - `splitter_id` string, required
  - `version_id` string, required
  - `version` integer, required
  - `status` 'succeeded' | 'waiting_for_review', required
  - `segment_count` integer, required
  - `review_count` integer, required
  - `segments` object[], required
    - `id` string, required
    - `segment_key` string, required
    - `ordinal` integer, required
    - `page_spans` object[], required
      - `start_page` integer, required
      - `end_page` integer, required
    - `page_count` integer, required
    - `review_status` 'not_required' | 'pending' | 'approved' | 'rejected', required
    - `destination_table_id` string, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Workflow error

---

[API](https://skmtc.dev/pdfparse/apis/pdfparse-api.md) · [All operations](https://skmtc.dev/pdfparse/apis/pdfparse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pdfparse/apis/pdfparse-api/revisions/fb9f7c930c6d?raw)