API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Parsing

Parse File

POST/api/v2/parse

Get Parse Job

GET/api/v2/parse/{job_id}

List Parse Jobs

GET/api/v2/parse

ModelsExpand Collapse

BBox object { h, w, x, 6 more }

Bounding box with coordinates and optional metadata.

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

CodeItem object { md, value, bbox, 2 more }

md: string

Markdown representation preserving formatting

value: string

Code content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

language: optional string

Programming language identifier

type: optional "code"

Code block item type

FailPageMode = "blank_page" or "error_message" or "raw_text"

Enum for representing the different available page error handling modes.

One of the following:

"blank_page"

"error_message"

"raw_text"

FooterItem object { items, md, bbox, type }

items: array of CodeItem { md, value, bbox, 2 more } or HeadingItem { level, md, value, 2 more } or ImageItem { caption, md, url, 2 more } or 4 more

List of items within the footer

One of the following:

CodeItem object { md, value, bbox, 2 more }

md: string

Markdown representation preserving formatting

value: string

Code content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

language: optional string

Programming language identifier

type: optional "code"

Code block item type

HeadingItem object { level, md, value, 2 more }

level: number

Heading level (1-6)

md: string

Markdown representation preserving formatting

value: string

Heading text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "heading"

Heading item type

ImageItem object { caption, md, url, 2 more }

caption: string

Image caption

md: string

Markdown representation preserving formatting

url: string

URL to the image

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "image"

Image item type

LinkItem object { md, text, url, 2 more }

md: string

Markdown representation preserving formatting

text: string

Display text of the link

url: string

URL of the link

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "link"

Link item type

ListItem object { items, md, ordered, 2 more }

items: array of TextItem { md, value, bbox, type } or ListItem { items, md, ordered, 2 more }

List of nested text or list items

One of the following:

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

ListItem { items, md, ordered, 2 more }

md: string

Markdown representation preserving formatting

ordered: boolean

Whether the list is ordered or unordered

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "list"

List item type

TableItem object { csv, html, md, 6 more }

csv: string

CSV representation of the table

html: string

HTML representation of the table

md: string

Markdown representation preserving formatting

rows: array of array of string or number

Table data as array of arrays (string, number, or null)

One of the following:

string

number

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

merged_from_pages: optional array of number

List of page numbers with tables that were merged into this table (e.g., [1, 2, 3, 4])

merged_into_page: optional number

Populated when merged into another table. Page number where the full merged table begins (used on empty tables).

parse_concerns: optional array of object { details, type }

Quality concerns detected during table extraction, indicating the table may have issues

details: string

Human-readable details about the concern

type: string

Type of parse concern (e.g. header_value_type_mismatch, inconsistent_row_cell_count)

type: optional "table"

Table item type

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

md: string

Markdown representation preserving formatting

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "footer"

Page footer container

Form object { json, list }

One form detected on a page, in two representations of the same content.

json: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Structured representation: an ordered tree of sections, fields, and tables

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable { rows, id, columns, 2 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

list: FormListItem { items, md, ordered, type }

Flattened list representation of the same content

items: array of FormListTextItem { md, value, type } or FormListItem { items, md, ordered, type }

Nested lines and sub-lists, in the form’s reading order

One of the following:

FormListTextItem object { md, value, type }

One line of a form’s list representation.

md: string

Markdown representation of the line

value: string

Line content (e.g. ‘[1a] Wages: 29,513’)

type: optional "text"

Text line

FormListItem object { items, md, ordered, type }

The list representation of form content: nested lists of rendered field lines.

md: string

Markdown representation of this list

ordered: boolean

Whether the list is ordered

type: optional "list"

List node

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

FormListItem object { items, md, ordered, type }

The list representation of form content: nested lists of rendered field lines.

items: array of FormListTextItem { md, value, type } or FormListItem { items, md, ordered, type }

Nested lines and sub-lists, in the form’s reading order

One of the following:

FormListTextItem object { md, value, type }

One line of a form’s list representation.

md: string

Markdown representation of the line

value: string

Line content (e.g. ‘[1a] Wages: 29,513’)

type: optional "text"

Text line

FormListItem object { items, md, ordered, type }

The list representation of form content: nested lists of rendered field lines.

md: string

Markdown representation of this list

ordered: boolean

Whether the list is ordered

type: optional "list"

List node

FormListTextItem object { md, value, type }

One line of a form’s list representation.

md: string

Markdown representation of the line

value: string

Line content (e.g. ‘[1a] Wages: 29,513’)

type: optional "text"

Text line

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

FormTable { rows, id, columns, 2 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

HeaderItem object { items, md, bbox, type }

items: array of CodeItem { md, value, bbox, 2 more } or HeadingItem { level, md, value, 2 more } or ImageItem { caption, md, url, 2 more } or 4 more

List of items within the header

One of the following:

CodeItem object { md, value, bbox, 2 more }

md: string

Markdown representation preserving formatting

value: string

Code content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

language: optional string

Programming language identifier

type: optional "code"

Code block item type

HeadingItem object { level, md, value, 2 more }

level: number

Heading level (1-6)

md: string

Markdown representation preserving formatting

value: string

Heading text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "heading"

Heading item type

ImageItem object { caption, md, url, 2 more }

caption: string

Image caption

md: string

Markdown representation preserving formatting

url: string

URL to the image

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "image"

Image item type

LinkItem object { md, text, url, 2 more }

md: string

Markdown representation preserving formatting

text: string

Display text of the link

url: string

URL of the link

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "link"

Link item type

ListItem object { items, md, ordered, 2 more }

items: array of TextItem { md, value, bbox, type } or ListItem { items, md, ordered, 2 more }

List of nested text or list items

One of the following:

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

ListItem { items, md, ordered, 2 more }

md: string

Markdown representation preserving formatting

ordered: boolean

Whether the list is ordered or unordered

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "list"

List item type

TableItem object { csv, html, md, 6 more }

csv: string

CSV representation of the table

html: string

HTML representation of the table

md: string

Markdown representation preserving formatting

rows: array of array of string or number

Table data as array of arrays (string, number, or null)

One of the following:

string

number

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

merged_from_pages: optional array of number

List of page numbers with tables that were merged into this table (e.g., [1, 2, 3, 4])

merged_into_page: optional number

Populated when merged into another table. Page number where the full merged table begins (used on empty tables).

parse_concerns: optional array of object { details, type }

Quality concerns detected during table extraction, indicating the table may have issues

details: string

Human-readable details about the concern

type: string

Type of parse concern (e.g. header_value_type_mismatch, inconsistent_row_cell_count)

type: optional "table"

Table item type

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

md: string

Markdown representation preserving formatting

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "header"

Page header container

HeadingItem object { level, md, value, 2 more }

level: number

Heading level (1-6)

md: string

Markdown representation preserving formatting

value: string

Heading text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "heading"

Heading item type

ImageItem object { caption, md, url, 2 more }

caption: string

Image caption

md: string

Markdown representation preserving formatting

url: string

URL to the image

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "image"

Image item type

LinkItem object { md, text, url, 2 more }

md: string

Markdown representation preserving formatting

text: string

Display text of the link

url: string

URL of the link

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "link"

Link item type

ListItem object { items, md, ordered, 2 more }

items: array of TextItem { md, value, bbox, type } or ListItem { items, md, ordered, 2 more }

List of nested text or list items

One of the following:

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

ListItem object { items, md, ordered, 2 more }

md: string

Markdown representation preserving formatting

ordered: boolean

Whether the list is ordered or unordered

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "list"

List item type

LlamaParseSupportedFileExtensions = ".abw" or ".awt" or ".azw" or 144 more

Enum for supported file extensions.

One of the following:

".abw"

".awt"

".azw"

".azw3"

".azw4"

".bmp"

".cb7"

".cbc"

".cbr"

".cbz"

".cgm"

".chm"

".csv"

".cwk"

".dbf"

".dif"

".djvu"

".doc"

".docm"

".docx"

".dot"

".dotm"

".dotx"

".epub"

".et"

".eth"

".fb2"

".fbz"

".fodg"

".fodp"

".fods"

".fodt"

".fopd"

".gif"

".heic"

".heif"

".htm"

".html"

".htmlz"

".hwp"

".jpeg"

".jpg"

".key"

".lit"

".lrf"

".lwp"

".m4a"

".mcw"

".md"

".mobi"

".mp3"

".mp4"

".mpeg"

".mpga"

".mw"

".mwd"

".numbers"

".odf"

".odg"

".odp"

".ods"

".odt"

".otg"

".otp"

".ots"

".ott"

".pages"

".pbd"

".pdb"

".pdf"

".pml"

".png"

".pot"

".potm"

".potx"

".ppt"

".pptm"

".pptx"

".prc"

".prn"

".psw"

".qpw"

".rb"

".rtf"

".sda"

".sdd"

".sdp"

".sdw"

".sgl"

".slk"

".snb"

".stc"

".std"

".sti"

".stw"

".svg"

".sxc"

".sxd"

".sxg"

".sxi"

".sxm"

".sxw"

".sylk"

".tcr"

".tif"

".tiff"

".tsv"

".txtz"

".uof"

".uop"

".uos"

".uos1"

".uos2"

".uot"

".vdx"

".vor"

".vsd"

".vsdm"

".vsdx"

".wav"

".wb1"

".wb2"

".wb3"

".webm"

".webp"

".wk1"

".wk2"

".wk3"

".wk4"

".wks"

".wn"

".wpd"

".wps"

".wpt"

".wq1"

".wq2"

".wri"

".xhtm"

".xlr"

".xls"

".xlsb"

".xlsm"

".xlsx"

".xlw"

".xml"

".yxmd"

".zabw"

ParsingJob object { id, status, error_code, error_message }

A parse job (v1).

id: string

Unique parse job identifier

status: StatusEnum

Current job status

One of the following:

"CANCELLED"

"ERROR"

"PARTIAL_SUCCESS"

"PENDING"

"SUCCESS"

error_code: optional string

Machine-readable error code when failed

error_message: optional string

Human-readable error details when failed

ParsingLanguages = "abq" or "ady" or "af" or 83 more

Enum for representing the languages supported by the parser.

One of the following:

"abq"

"ady"

"af"

"ang"

"ar"

"as"

"ava"

"az"

"be"

"bg"

"bgc"

"bh"

"bho"

"bn"

"bs"

"ch_sim"

"ch_tra"

"che"

"cs"

"cy"

"da"

"dar"

"de"

"en"

"es"

"et"

"fa"

"fr"

"ga"

"gom"

"hi"

"hr"

"hu"

"id"

"inh"

"is"

"it"

"ja"

"kbd"

"kn"

"ko"

"ku"

"la"

"lbe"

"lez"

"lt"

"lv"

"mah"

"mai"

"mi"

"mn"

"mni"

"mr"

"ms"

"mt"

"ne"

"new"

"nl"

"no"

"oc"

"pi"

"pl"

"pt"

"ro"

"rs_cyrillic"

"rs_latin"

"ru"

"sa"

"sck"

"sk"

"sl"

"sq"

"sv"

"sw"

"ta"

"tab"

"te"

"th"

"tjk"

"tl"

"tr"

"ug"

"uk"

"ur"

"uz"

"vi"

ParsingMode = "parse_document_with_agent" or "parse_document_with_llm" or "parse_document_with_lvm" or 5 more

Enum for representing the mode of parsing to be used.

One of the following:

"parse_document_with_agent"

"parse_document_with_llm"

"parse_document_with_lvm"

"parse_page_with_agent"

"parse_page_with_layout_agent"

"parse_page_with_llm"

"parse_page_with_lvm"

"parse_page_without_llm"

StatusEnum = "CANCELLED" or "ERROR" or "PARTIAL_SUCCESS" or 2 more

Enum for representing the status of a job

One of the following:

"CANCELLED"

"ERROR"

"PARTIAL_SUCCESS"

"PENDING"

"SUCCESS"

TableItem object { csv, html, md, 6 more }

csv: string

CSV representation of the table

html: string

HTML representation of the table

md: string

Markdown representation preserving formatting

rows: array of array of string or number

Table data as array of arrays (string, number, or null)

One of the following:

string

number

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

merged_from_pages: optional array of number

List of page numbers with tables that were merged into this table (e.g., [1, 2, 3, 4])

merged_into_page: optional number

Populated when merged into another table. Page number where the full merged table begins (used on empty tables).

parse_concerns: optional array of object { details, type }

Quality concerns detected during table extraction, indicating the table may have issues

details: string

Human-readable details about the concern

type: string

Type of parse concern (e.g. header_value_type_mismatch, inconsistent_row_cell_count)

type: optional "table"

Table item type

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

ParsingCreateResponse object { id, project_id, status, 6 more }

A parse job.

id: string

Unique parse job identifier

project_id: string

Project this job belongs to

status: "CANCELLED" or "COMPLETED" or "FAILED" or 2 more

Current job status: PENDING, RUNNING, COMPLETED, FAILED, or CANCELLED

One of the following:

"CANCELLED"

"COMPLETED"

"FAILED"

"PENDING"

"RUNNING"

created_at: optional string

Creation datetime

formatdate-time

error_message: optional string

Error details when status is FAILED

name: optional string

Optional display name for this parse job

tier: optional string

Parsing tier used for this job

updated_at: optional string

Update datetime

formatdate-time

user_metadata: optional map[string]

Key/value tags associated with this job.

ParsingGetResponse object { job, forms, images_content_metadata, 9 more }

Parse result response with job status and optional content or metadata.

The job field is always included. Other fields are included based on expand parameters.

job: object { id, project_id, status, 6 more }

Parse job status and metadata

id: string

Unique parse job identifier

project_id: string

Project this job belongs to

status: "CANCELLED" or "COMPLETED" or "FAILED" or 2 more

Current job status: PENDING, RUNNING, COMPLETED, FAILED, or CANCELLED

One of the following:

"CANCELLED"

"COMPLETED"

"FAILED"

"PENDING"

"RUNNING"

created_at: optional string

Creation datetime

formatdate-time

error_message: optional string

Error details when status is FAILED

name: optional string

Optional display name for this parse job

tier: optional string

Parsing tier used for this job

updated_at: optional string

Update datetime

formatdate-time

user_metadata: optional map[string]

Key/value tags associated with this job.

forms: optional object { pages }

Per-page form analysis results (one entry per page).

pages: array of object { forms, page_number, success } or object { error, page_number, success }

List of form pages or failed page entries

One of the following:

FormsResultPage object { forms, page_number, success }

Forms found on one page. Pages without form content have an empty forms list.

forms: array of Form { json, list }

Forms detected on the page

json: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Structured representation: an ordered tree of sections, fields, and tables

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

FormSection { items, id, label, type }

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable object { rows, id, columns, 2 more }

A fillable grid printed on the form: repeating records or a row-by-column matrix.

rows: array of array of string or FormTableCellItems { items }

Table cells: a verbatim string, null for a printed-but-blank cell, or an object holding the cell’s own form nodes

One of the following:

string

FormTableCellItems object { items }

A table cell holding its own form nodes (e.g. a checkbox column).

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Form nodes inside the cell

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable { rows, id, columns, 2 more }

FormSection object { items, id, label, type }

A grouping of form content, in the form’s reading order.

items: array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Child form nodes in reading order

One of the following:

FormField object { field, id, isEmpty, 4 more }

One labeled form entry: a text input, checkbox, select group, or signature line.

field: "checkbox" or "multi_select" or "signature" or 2 more

Kind of entry: text (any free-text input), checkbox, single_select, multi_select, or signature

One of the following:

"checkbox"

"multi_select"

"signature"

"single_select"

"text"

id: optional string

Field number/letter printed on the form (e.g. ‘1a’), if any

isEmpty: optional boolean

True for a printed-but-blank text field (mutually exclusive with value)

label: optional string

Printed field caption, if any

type: optional "field"

Form field node

value: optional string or boolean

Entered content: verbatim text for text fields, or a boolean for checkbox (checked) and signature (signed). Absent on blank text fields and on select groups

One of the following:

string

boolean

valueItems: optional array of FormField { field, id, isEmpty, 4 more } or FormSection { items, id, label, type } or FormTable { rows, id, columns, 2 more }

Options of a single_select/multi_select group (only on select fields)

One of the following:

FormField { field, id, isEmpty, 4 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

FormSection { items, id, label, type }

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form (e.g. ‘Part III’), if any

label: optional string

Printed section heading, if any

type: optional "section"

Form section node

FormTable { rows, id, columns, 2 more }

id: optional string

Identifier printed on the form, if any

columns: optional array of string

Printed column headers in order, if any

label: optional string

Printed table caption, if any

type: optional "table"

Form table node

list: FormListItem { items, md, ordered, type }

Flattened list representation of the same content

items: array of FormListTextItem { md, value, type } or FormListItem { items, md, ordered, type }

Nested lines and sub-lists, in the form’s reading order

One of the following:

FormListTextItem object { md, value, type }

One line of a form’s list representation.

md: string

Markdown representation of the line

value: string

Line content (e.g. ‘[1a] Wages: 29,513’)

type: optional "text"

Text line

FormListItem object { items, md, ordered, type }

The list representation of form content: nested lists of rendered field lines.

md: string

Markdown representation of this list

ordered: boolean

Whether the list is ordered

type: optional "list"

List node

page_number: number

Page number of the document

success: true

Success indicator

FailedFormsPage object { error, page_number, success }

A page whose processing failed.

error: string

Error message describing the failure

page_number: number

Page number of the document

success: false

Failure indicator

images_content_metadata: optional object { images, total_count }

Metadata for all extracted images.

images: array of object { filename, index, bbox, 4 more }

List of image metadata with presigned URLs

filename: string

Image filename (e.g., ‘image_0.png’)

index: number

Index of the image in the extraction order

bbox: optional object { h, w, x, y }

Bounding box for an image on its page.

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

category: optional "embedded" or "layout" or "screenshot"

Image category: ‘screenshot’ (full page), ‘embedded’ (images in document), or ‘layout’ (cropped from layout detection)

One of the following:

"embedded"

"layout"

"screenshot"

content_type: optional string

MIME type of the image

presigned_url: optional string

Presigned URL to download the image

Deprecatedsize_bytes: optional number

Deprecated: always returns None. Will be removed in a future release.

total_count: number

Total number of extracted images

items: optional object { pages }

Structured JSON result (if requested)

pages: array of object { items, page_height, page_number, 2 more } or object { error, page_number, success }

List of structured pages or failed page entries

One of the following:

StructuredResultPage object { items, page_height, page_number, 2 more }

items: array of CodeItem { md, value, bbox, 2 more } or FooterItem { items, md, bbox, type } or HeaderItem { items, md, bbox, type } or 6 more

List of structured items on the page

One of the following:

CodeItem object { md, value, bbox, 2 more }

md: string

Markdown representation preserving formatting

value: string

Code content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

language: optional string

Programming language identifier

type: optional "code"

Code block item type

FooterItem object { items, md, bbox, type }

items: array of CodeItem { md, value, bbox, 2 more } or HeadingItem { level, md, value, 2 more } or ImageItem { caption, md, url, 2 more } or 4 more

List of items within the footer

One of the following:

CodeItem object { md, value, bbox, 2 more }

md: string

Markdown representation preserving formatting

value: string

Code content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

language: optional string

Programming language identifier

type: optional "code"

Code block item type

HeadingItem object { level, md, value, 2 more }

level: number

Heading level (1-6)

md: string

Markdown representation preserving formatting

value: string

Heading text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "heading"

Heading item type

ImageItem object { caption, md, url, 2 more }

caption: string

Image caption

md: string

Markdown representation preserving formatting

url: string

URL to the image

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "image"

Image item type

LinkItem object { md, text, url, 2 more }

md: string

Markdown representation preserving formatting

text: string

Display text of the link

url: string

URL of the link

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "link"

Link item type

ListItem object { items, md, ordered, 2 more }

items: array of TextItem { md, value, bbox, type } or ListItem { items, md, ordered, 2 more }

List of nested text or list items

One of the following:

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

ListItem { items, md, ordered, 2 more }

md: string

Markdown representation preserving formatting

ordered: boolean

Whether the list is ordered or unordered

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "list"

List item type

TableItem object { csv, html, md, 6 more }

csv: string

CSV representation of the table

html: string

HTML representation of the table

md: string

Markdown representation preserving formatting

rows: array of array of string or number

Table data as array of arrays (string, number, or null)

One of the following:

string

number

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

merged_from_pages: optional array of number

List of page numbers with tables that were merged into this table (e.g., [1, 2, 3, 4])

merged_into_page: optional number

Populated when merged into another table. Page number where the full merged table begins (used on empty tables).

parse_concerns: optional array of object { details, type }

Quality concerns detected during table extraction, indicating the table may have issues

details: string

Human-readable details about the concern

type: string

Type of parse concern (e.g. header_value_type_mismatch, inconsistent_row_cell_count)

type: optional "table"

Table item type

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

md: string

Markdown representation preserving formatting

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "footer"

Page footer container

HeaderItem object { items, md, bbox, type }

items: array of CodeItem { md, value, bbox, 2 more } or HeadingItem { level, md, value, 2 more } or ImageItem { caption, md, url, 2 more } or 4 more

List of items within the header

One of the following:

CodeItem object { md, value, bbox, 2 more }

md: string

Markdown representation preserving formatting

value: string

Code content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

language: optional string

Programming language identifier

type: optional "code"

Code block item type

HeadingItem object { level, md, value, 2 more }

level: number

Heading level (1-6)

md: string

Markdown representation preserving formatting

value: string

Heading text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "heading"

Heading item type

ImageItem object { caption, md, url, 2 more }

caption: string

Image caption

md: string

Markdown representation preserving formatting

url: string

URL to the image

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "image"

Image item type

LinkItem object { md, text, url, 2 more }

md: string

Markdown representation preserving formatting

text: string

Display text of the link

url: string

URL of the link

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "link"

Link item type

ListItem object { items, md, ordered, 2 more }

items: array of TextItem { md, value, bbox, type } or ListItem { items, md, ordered, 2 more }

List of nested text or list items

One of the following:

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

ListItem { items, md, ordered, 2 more }

md: string

Markdown representation preserving formatting

ordered: boolean

Whether the list is ordered or unordered

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "list"

List item type

TableItem object { csv, html, md, 6 more }

csv: string

CSV representation of the table

html: string

HTML representation of the table

md: string

Markdown representation preserving formatting

rows: array of array of string or number

Table data as array of arrays (string, number, or null)

One of the following:

string

number

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

merged_from_pages: optional array of number

List of page numbers with tables that were merged into this table (e.g., [1, 2, 3, 4])

merged_into_page: optional number

Populated when merged into another table. Page number where the full merged table begins (used on empty tables).

parse_concerns: optional array of object { details, type }

Quality concerns detected during table extraction, indicating the table may have issues

details: string

Human-readable details about the concern

type: string

Type of parse concern (e.g. header_value_type_mismatch, inconsistent_row_cell_count)

type: optional "table"

Table item type

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

md: string

Markdown representation preserving formatting

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "header"

Page header container

HeadingItem object { level, md, value, 2 more }

level: number

Heading level (1-6)

md: string

Markdown representation preserving formatting

value: string

Heading text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "heading"

Heading item type

ImageItem object { caption, md, url, 2 more }

caption: string

Image caption

md: string

Markdown representation preserving formatting

url: string

URL to the image

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "image"

Image item type

LinkItem object { md, text, url, 2 more }

md: string

Markdown representation preserving formatting

text: string

Display text of the link

url: string

URL of the link

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "link"

Link item type

ListItem object { items, md, ordered, 2 more }

items: array of TextItem { md, value, bbox, type } or ListItem { items, md, ordered, 2 more }

List of nested text or list items

One of the following:

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

ListItem { items, md, ordered, 2 more }

md: string

Markdown representation preserving formatting

ordered: boolean

Whether the list is ordered or unordered

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "list"

List item type

TableItem object { csv, html, md, 6 more }

csv: string

CSV representation of the table

html: string

HTML representation of the table

md: string

Markdown representation preserving formatting

rows: array of array of string or number

Table data as array of arrays (string, number, or null)

One of the following:

string

number

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

merged_from_pages: optional array of number

List of page numbers with tables that were merged into this table (e.g., [1, 2, 3, 4])

merged_into_page: optional number

Populated when merged into another table. Page number where the full merged table begins (used on empty tables).

parse_concerns: optional array of object { details, type }

Quality concerns detected during table extraction, indicating the table may have issues

details: string

Human-readable details about the concern

type: string

Type of parse concern (e.g. header_value_type_mismatch, inconsistent_row_cell_count)

type: optional "table"

Table item type

TextItem object { md, value, bbox, type }

md: string

Markdown representation preserving formatting

value: string

Text content

bbox: optional array of BBox { h, w, x, 6 more }

List of bounding boxes

h: number

Height of the bounding box

w: number

Width of the bounding box

x: number

X coordinate of the bounding box

y: number

Y coordinate of the bounding box

confidence: optional number

Confidence score

end_index: optional number

End index in the text

label: optional string

Label for the bounding box

r: optional number

Optional visual text rotation angle in degrees. Omitted when unrotated.

start_index: optional number

Start index in the text

type: optional "text"

Text item type

page_height: number

Height of the page in points

page_number: number

Page number of the document

page_width: number

Width of the page in points

success: true

Success indicator

FailedStructuredPage object { error, page_number, success }

error: string

Error message describing the failure

page_number: number

Page number of the document

success: false

Failure indicator

job_metadata: optional map[unknown]

Job execution metadata (if requested)

markdown: optional object { pages }

Markdown result (if requested)

pages: array of object { markdown, page_number, success, 2 more } or object { error, page_number, success }

List of markdown pages or failed page entries

One of the following:

MarkdownResultPage object { markdown, page_number, success, 2 more }

markdown: string

Markdown content of the page

page_number: number

Page number of the document

success: true

Success indicator

footer: optional string

Footer of the page in markdown

header: optional string

Header of the page in markdown

FailedMarkdownPage object { error, page_number, success }

error: string

Error message describing the failure

page_number: number

Page number of the document

success: false

Failure indicator

markdown_full: optional string

Full raw markdown content (if requested)

metadata: optional object { pages }

Result containing metadata (page level and general) for the parsed document.

pages: array of object { page_number, confidence, cost_optimized, 5 more }

List of page metadata entries

page_number: number

Page number of the document

confidence: optional number

Confidence score for the page parsing (0-1)

cost_optimized: optional boolean

Whether cost-optimized parsing was used for the page

original_orientation_angle: optional number

Original orientation angle of the page in degrees

printed_page_number: optional string

Printed page number as it appears in the document

slide_section_name: optional string

Section name from presentation slides

speaker_notes: optional string

Speaker notes from presentation slides

triggered_auto_mode: optional boolean

Whether auto mode was triggered for the page

raw_parameters: optional map[unknown]

result_content_metadata: optional map[object { size_bytes, exists, presigned_url } ]

Metadata including size, existence, and presigned URLs for result files

size_bytes: number

Size of the result file in bytes

exists: optional boolean

Whether the result file exists in S3

presigned_url: optional string

Presigned URL to download the result file

text: optional object { pages }

Plain text result (if requested)

pages: array of object { page_number, text }

List of text pages

page_number: number

Page number of the document

text: string

Plain text content of the page

text_full: optional string

Full raw text content (if requested)

ParsingListResponse object { id, project_id, status, 6 more }

A parse job.

id: string

Unique parse job identifier

project_id: string

Project this job belongs to

status: "CANCELLED" or "COMPLETED" or "FAILED" or 2 more

Current job status: PENDING, RUNNING, COMPLETED, FAILED, or CANCELLED

One of the following:

"CANCELLED"

"COMPLETED"

"FAILED"

"PENDING"

"RUNNING"

created_at: optional string

Creation datetime

formatdate-time

error_message: optional string

Error details when status is FAILED

name: optional string

Optional display name for this parse job

tier: optional string

Parsing tier used for this job

updated_at: optional string

Update datetime

formatdate-time

user_metadata: optional map[string]

Key/value tags associated with this job.