---
title: "Split Fax into PDFs"
method: POST
path: "/v1/fax/{faxId}/split"
tags: ["Fax Management"]
---

# Split Fax into PDFs

`POST /v1/fax/{faxId}/split`

Create PDF splits from the current pageData and updates the splits field. Old splits are deleted before regenerating.

## Path parameters

- `faxId` string, required

## Response `200`

Default Response

- object
  - `success` boolean, required
  - `message` string, required
  - `results` object
    - `splitCount` integer
    - `pageCount` integer
    - `errors` string[]
  - `fax` object
    - `_id` string
    - `faxId` string
    - `storagePath` string
    - `receivedAt` string, date-time
    - `status` 'received' | 'queued' | 'processing' | 'completed' | 'error'
    - `attempts` integer
    - `lastError` string
    - `startedAt` string, date-time
    - `finishedAt` string, date-time
    - `scannedAt` string, date-time
    - `brandId` string, nullable
    - `pageData` object[]
      - `pageNum` integer
      - `codes` object[]
        - `raw` string — Original scanned QR code value
        - `data` object — Extracted data from parsing the raw QR string (orderCode, orderNumber, formId, url, etc.)
        - `derived` object — Derived/resolved data from DB lookups (orderItemId, etc.)
      - `formId` string, nullable
      - `orderItemId` string, nullable
    - `splits` object[]
      - `formId` string, nullable
      - `orderItemId` string, nullable
      - `storagePath` string
      - `pageNums` integer[]
      - `createdAt` string, date-time
      - `meta` object
        - `pageCount` integer
        - `fileSize` integer
    - `meta` object
      - `pageCount` integer
      - `fileSize` integer

## Other responses

- `400` — Default Response
- `401` — Default Response
- `404` — Default Response
- `409` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/versions/e6e553c2594a/schema)