> This page is for version v2024-12-23.
> For other versions, use one of these documentation indexes:
> - v2026-02-09 (default): https://docs.extend.ai/2026-02-09/llms.txt
> - v2025-04-21: https://docs.extend.ai/2025-04-21/llms.txt
> - v2024-12-23: https://docs.extend.ai/2024-12-23/llms.txt

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.extend.ai/llms.txt
> Use this file to discover all available pages before exploring further.
>
> ## API version
> The current API version is `2026-02-09`, served at the site root (no version prefix in URLs).
> If this page URL contains `/2025-04-21/` or `/2024-12-23/`, you are reading an older API version.
> Prefer the current docs at https://docs.extend.ai/llms.txt unless the user explicitly needs that older version.
> Do not treat older-version pages as the source of truth for new integrations.

# The Block Object

## Overview

A Block represents a distinct content element within a document, such as a paragraph of text, a heading, a table, or a figure. Blocks are the fundamental units that make up chunks in parsed documents.

## Block Object Structure

**`object`** `string`

The type of object. Always "block".

---

**`id`** `string`

A unique identifier for the block, deterministically generated as a hash of the block content.

---

**`type`** `string`

The type of block. Possible values include:

* `text`: Regular text content
* `heading`: Section or document headings
* `section_heading`: Subsection headings
* `table`: Tabular data with rows and columns
* `figure`: Images, charts, or diagrams

---

**`content`** `string`

The textual content of the block, formatted according to the target format specified in the parse request.

---

**`details`** `object`

Additional details specific to the block type. The structure varies depending on the block type.

#### Block Type Details

**`oneOf`** `object`

#### Figure Details

**`type`** `string` — default: figure\_details

Indicates this is a figure details object.

---

**`imageUrl`** `string`

URL to the clipped/segmented figure image. Only set if the option `figureImageClippingEnabled` is true (which is default true).

---

**`figureType`** `string`

The refined type of figure - only set when figure classification and summarization is enabled. Possible values:

* `image`: A photographic image
* `chart`: A data chart or graph
* `diagram`: A schematic or diagram
* `logo`: A company or brand logo
* `other`: Any other type of figure

---

#### Table Details

**`type`** `string` — default: table\_details

Indicates this is a table details object.

---

**`rowCount`** `number`

The number of rows in the table.

---

**`columnCount`** `number`

The number of columns in the table.

---

---

---

**`metadata`** `object`

Metadata about the block.

#### properties

**`pageNumber`** `number`

The page number where the block appears in the document.

---

---

**`polygon`** `array`

An array of points defining the polygon that bounds the block on the page.
Each point is an object with `x` and `y` coordinates.

---

**`boundingBox`** `object`

A simplified rectangular bounding box for the block, derived from the polygon.

#### properties

**`top`** `number`

The y-coordinate of the top edge of the bounding box.

---

**`left`** `number`

The x-coordinate of the left edge of the bounding box.

---

**`width`** `number`

The width of the bounding box.

---

**`height`** `number`

The height of the bounding box.

---

---

## Block Type Examples

**`Text Block`**

```json Text Block
{
  "object": "block",
  "id": "block_1a2b3c4d5e",
  "type": "text",
  "content": "This is a paragraph of text content that appears in the document.",
  "details": {},
  "metadata": {
    "pageNumber": 1
  },
  "polygon": [
    {"x": 100, "y": 50},
    {"x": 500, "y": 50},
    {"x": 500, "y": 80},
    {"x": 100, "y": 80}
  ],
  "boundingBox": {
    "top": 50,
    "left": 100,
    "width": 400,
    "height": 30
  }
}
```

**`Heading Block`**

```json Heading Block
{
  "object": "block",
  "id": "block_2b3c4d5e6f",
  "type": "heading",
  "content": "Document Title",
  "details": {},
  "metadata": {
    "pageNumber": 1
  },
  "polygon": [
    {"x": 200, "y": 20},
    {"x": 400, "y": 20},
    {"x": 400, "y": 40},
    {"x": 200, "y": 40}
  ],
  "boundingBox": {
    "top": 20,
    "left": 200,
    "width": 200,
    "height": 20
  }
}
```