---
title: "Extract Document Pages"
method: POST
path: "/documents/pages"
tags: ["Documents"]
---

# Extract Document Pages

`POST /documents/pages`

## Request

- Base URL: `https://api.morphik.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.morphik.ai/documents/pages`
- Auth: none declared

Extract specific pages from a document (PDF, PowerPoint, or Word) as base64-encoded images or URLs.
When output_format="url", pages that fail URL generation fall back to base64 data URIs (mixed output possible).

## Headers

- `authorization` string, nullable

## Request body

- DocumentPagesRequest: Request model for extracting pages from a document
  - `document_id` string, required: ID of the document to extract pages from
  - `start_page` integer, required: Starting page number (1-indexed)
  - `end_page` integer, required: Ending page number (1-indexed)
  - `output_format` 'base64' | 'url', nullable: How to return page images: base64 (default) or url

## Response `200`

Successful Response

- DocumentPagesResponse: Response for document pages extraction endpoint
  - `document_id` string, required
  - `pages` string[], required
  - `start_page` integer, required
  - `end_page` integer, required
  - `total_pages` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-01-22** `2d9291c3821d`: 2 info
  - `header` request parameter `authorization` list-of-types was widened by adding types `null`
  - for the `header` request parameter `authorization`, the type was generalized from `string` to no type
- **2025-12-22** `eaabe7b65b47`: 1 info
  - added the new optional request property `output_format`
- **2025-11-05** `9ade02dd7b1d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/morphik-org/apis/morphik-api/changes/documents/pages/post.md)

---

[API](https://skmtc.dev/morphik-org/apis/morphik-api.md) - [All operations](https://skmtc.dev/morphik-org/apis/morphik-api/llms.txt) - [OpenAPI document](https://skmtc.dev/morphik-org/apis/morphik-api/revisions/45d77e08d406?raw)