The Block Object

Detailed information about the Block object structure and types returned by the /parse API endpoint.

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.

Hide Block Type Details

oneOf · object

Hide 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

Show 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.

Show 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.

Show 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

{
  "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
  }
}