pdfedge
API reference › Split

Split a PDF into several: by ranges, every n pages, or one per page

POST/v1/split

POST/v1/split

Split a PDF into several: by ranges, every n pages, or one per page

Answers with a file per part, or with one zip (zip: true, needed past 500 parts). Form fields stay fillable in each part.

REQUEST BODY · APPLICATION/JSON · REQUIRED
{
  "file": "fil_8kq2wzm4tnb7hdc3vrex",
  "ranges": [
    "1-2",
    "3-"
  ]
}
In the full reference
REQUEST
curl -X POST "https://api.pdfedge.com/v1/split" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "file": "fil_8kq2wzm4tnb7hdc3vrex",
  "ranges": [
    "1-2",
    "3-"
  ]
}'
RESPONSE
200With response=binary: the file itself, with X-File-Id and X-File-Url headers
201Created
{
  "object": "split",
  "files": [
    {
      "id": "fil_8kq2wzm4tnb7hdc3vrex",
      "object": "file",
      "kind": "result",
      "operation": "split",
      "name": "contract-pages-1-2.pdf",
      "format": "pdf",
      "content_type": "application/pdf",
      "pages": 2,
      "bytes": 284113,
      "url": "https://files.pdfedge.com/f/fil_8kq2wzm4tnb7hdc3vrex.pdf",
      "keep": "1d",
      "created": "2026-10-11T18:10:40Z",
      "expires": "2026-10-12T18:10:40Z",
      "units": 1
    }
  ],
  "units": 1
}
Try it — sign in first
Runs on a sandbox key: 200 requests a month. Your real key is for production.