> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getdeckle.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v1/pdf/split

> Split a PDF into multiple documents by page ranges.

# Split PDF

`POST https://api.getdeckle.dev/v1/pdf/split`

Split a single PDF into multiple documents based on page ranges.

## Request Body

| Parameter | Type         | Required | Description                                                                                                                       |
| --------- | ------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `pdf`     | string       | Yes      | Base64-encoded PDF document                                                                                                       |
| `ranges`  | number\[]\[] | No       | Array of page ranges. Each range is `[start]` or `[start, end]` (1-indexed, inclusive). If omitted, splits into individual pages. |
| `output`  | string       | No       | `"url"` (default) or `"base64"`                                                                                                   |

### Range Examples

| Range              | Result                                 |
| ------------------ | -------------------------------------- |
| `[1]`              | Page 1 only                            |
| `[1, 3]`           | Pages 1 through 3                      |
| `[[1, 2], [5, 8]]` | Two documents: pages 1-2 and pages 5-8 |

## Example

```bash theme={null}
curl -X POST https://api.getdeckle.dev/v1/pdf/split \
  -H "Authorization: Bearer dk_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "pdf": "<base64-encoded-pdf>",
    "ranges": [[1, 3], [4, 6]],
    "output": "url"
  }'
```

## Response (URL mode)

```json theme={null}
{
  "parts": [
    { "url": "https://cdn.getdeckle.dev/gen_abc123.pdf", "file_size": 45230 },
    { "url": "https://cdn.getdeckle.dev/gen_def456.pdf", "file_size": 32100 }
  ],
  "total": 2
}
```

## Response (base64 mode)

```json theme={null}
{
  "parts": [
    { "data": "<base64-encoded-pdf>", "file_size": 45230 },
    { "data": "<base64-encoded-pdf>", "file_size": 32100 }
  ],
  "total": 2
}
```

## Errors

| Status | Code               | Description                              |
| ------ | ------------------ | ---------------------------------------- |
| 400    | `VALIDATION_ERROR` | Invalid ranges or PDF exceeds size limit |
| 401    | `UNAUTHORIZED`     | Invalid or missing API key               |
| 429    | `RATE_LIMITED`     | Too many requests                        |
| 500    | `INTERNAL_ERROR`   | Server error during split                |