---
title: "Get Document Layout"
method: GET
path: "/documents/{document_id}/layout"
tags: ["documents"]
---

# Get Document Layout

`GET /documents/{document_id}/layout`

Get the extracted layout of a document, with per-item page regions.

## Path parameters

- `document_id` string, uuid, required

## Query parameters

- `pages` integer[], nullable — 1-indexed pages to include
- `labels` string[], nullable — DocItemLabels to include, e.g. `table`

## Response `200`

Successful Response

- DocumentLayoutOut — Extracted layout for one document.
  - `document_id` string, required — Document ID
  - `docling_version` string, required — docling-core schema version of the stored document
  - `num_items` integer, required — Number of items in this response
  - `num_pages` integer, required — Number of pages in this response
  - `pages` LayoutPageOut[] — Page geometry
    - `page_no` integer, required — 1-indexed page number
    - `width` number, required — Page width in points
    - `height` number, required — Page height in points
  - `items` LayoutItemOut[] — Layout items in reading order
    - `self_ref` string, required — Citation anchor, e.g. `#/texts/12`
    - `parent_ref` string, nullable — Reference of the parent node
    - `label` string, required — DocItemLabel, e.g. `text`, `table`, `picture`
    - `content_layer` string, nullable — Content layer, e.g. `body` or `furniture`
    - `level` integer, nullable — Heading level, when the item is a section header
    - `reading_order` integer, required — Position in document reading order
    - `text` string, nullable — Item text, when it has any
    - `html` string, nullable — Rendered HTML, for tables
    - `prov` ProvenanceOut[] — One entry per page region
      - `page_no` integer, required — 1-indexed page number
      - `bbox` BoundingBoxOut, required — A rectangle in page points.
        - `l` number, required — Left edge
        - `t` number, required — Top edge
        - `r` number, required — Right edge
        - `b` number, required — Bottom edge
        - `coord_origin` string — Origin the coordinates are measured from
      - `charspan` unknown[], required — Item-local character span, not a document offset
        - unknown

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/hf/apis/extralit-v1.md) · [All operations](https://skmtc.net/hf/apis/extralit-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hf/extralit-v1/revisions/ca32894f988c/schema)