Get Document Page | Captain Docs

import requests
BASE_URL = "https://api.captain.dev"
API_KEY = "your_api_key"
COLLECTION_NAME = "drug_labels"
DOCUMENT_ID = "f4a91c7e8b2d4a0c9e6f13b5a8d02744"
PAGE_NUMBER = 14
response = requests.get(
    f"{BASE_URL}/v3/collections/{COLLECTION_NAME}/documents/{DOCUMENT_ID}/pages/{PAGE_NUMBER}",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"include_regions": True},
)
page = response.json()
print(page["text"])

{
  "collection_name": "drug_labels",
  "document_id": "f4a91c7e8b2d4a0c9e6f13b5a8d02744",
  "page": 14,
  "text": "INDICATIONS AND USAGE\nRoseRx-A is indicated for the treatment of moderate to severe plaque psoriasis in adult patients who are candidates for systemic therapy or phototherapy.\n\nDOSAGE AND ADMINISTRATION\nThe recommended dose is 40mg administered by subcutaneous injection every other week. Dosage may be adjusted based on renal function.",
  "page_count": 42,
  "text_source": "ocr",
  "regions": [
    {
      "type": "heading",
      "text": "INDICATIONS AND USAGE",
      "page": 14,
      "bbox": {
        "top": 0.0619,
        "left": 0.0662,
        "width": 0.3382,
        "height": 0.0183
      },
      "confidence": "high",
      "image_url": null,
      "description": null
    },
    {
      "type": "text",
      "text": "RoseRx-A is indicated for the treatment of moderate to severe plaque psoriasis in adult patients who are candidates for systemic therapy or phototherapy.",
      "page": 14,
      "bbox": {
        "top": 0.0862,
        "left": 0.0662,
        "width": 0.8544,
        "height": 0.0445
      },
      "confidence": "high",
      "image_url": null,
      "description": null
    },
    {
      "type": "figure",
      "text": "Dosing schedule diagram: 40mg every other week, subcutaneous injection sites.",
      "page": 14,
      "bbox": {
        "top": 0.45,
        "left": 0.0662,
        "width": 0.4013,
        "height": 0.0788
      },
      "confidence": "high",
      "image_url": "https://captain-visual-citations.s3.amazonaws.com/crops/org_example/f4a91c7e8b2d4a0c9e6f13b5a8d02744/p14-0.png?AWSAccessKeyId=AKIAEXAMPLE&Expires=1785084004&Signature=EXAMPLESIGNATUREvalue%3D",
      "description": "Dosing schedule diagram for injection sites and frequency."
    }
  ],
  "warnings": []
}

Return one document page’s OCR text in reading order and, optionally, its layout regions.

Addressed by the same document_id returned by List Documents and Query, plus a page_number. No new ID scheme.

v1 is OCR-paged documents only. A document with no OCR page data (for example, a .txt or .docx file) returns a 404 with code document_has_no_pages; use Get Document or Get Chunk for those.

A blank in-range page returns 200 with empty text and a page_empty warning, not a 404. A document still indexing with partial OCR present returns 200 with a document_indexing warning rather than failing.

Return one document page's OCR text in reading order and, optionally, its layout regions. Addressed by the same `document_id` returned by [List Documents](/reference/v3/documents) and [Query](/reference/v3/query), plus a `page_number`. No new ID scheme. **v1 is OCR-paged documents only.** A document with no OCR page data (for example, a `.txt` or `.docx` file) returns a `404` with code `document_has_no_pages`; use [Get Document](/reference/v3/document) or [Get Chunk](/reference/v3/documents/chunk) for those. A blank in-range page returns `200` with empty `text` and a `page_empty` warning, not a `404`. A document still indexing with partial OCR present returns `200` with a `document_indexing` warning rather than failing.

Path parameters

collection_namestringRequired

document_idstringRequired

page_numberintegerRequired>=0

Query parameters

include_regionsbooleanOptionalDefaults to false

Response

Get Document Page response.

collection_namestring

document_idstring

pageinteger

The requested page number, echoed back.

textstring

The page’s full text in reading order. Empty string when the page exists but has no extractable text (see warnings).

page_countinteger or nullOptional

Best-effort total page count, derived from the document’s OCR data. Null when it cannot be determined.

text_sourceenumOptionalDefaults to ocr

Where text came from. Always ocr today; a future value would mean reconstructed text, not primary-source OCR.

regionslist of objects or nullOptional

Layout regions on this page when include_regions is true. Regions of type figure, chart, or image carry a presigned image_url.

warningslist of objectsOptional

Non-fatal conditions on this response, such as document_indexing (content may be incomplete) or page_empty (page exists, no extractable text).