API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Parsing

Parse File

parsing.create(ParsingCreateParams**kwargs) -> ParsingCreateResponse

POST/api/v2/parse

Get Parse Job

parsing.get(strjob_id, ParsingGetParams**kwargs) -> ParsingGetResponse

GET/api/v2/parse/{job_id}

List Parse Jobs

parsing.list(ParsingListParams**kwargs) -> SyncPaginatedCursor[ParsingListResponse]

GET/api/v2/parse

Cancel Parse Job

parsing.cancel(strjob_id, ParsingCancelParams**kwargs) -> ParsingCancelResponse

POST/api/v2/parse/{job_id}/cancel

Delete Parse Job

parsing.delete(strjob_id, ParsingDeleteParams**kwargs) -> ParsingDeleteResponse

DELETE/api/v2/parse/{job_id}

List Parse Versions

parsing.list_versions() -> ParsingListVersionsResponse

GET/api/v2/parse/versions

ModelsExpand Collapse

class BBox: …

Bounding box with coordinates and optional metadata.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

class CodeItem: …

md: str

Markdown representation preserving formatting

value: str

Code content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

language: Optional[str]

Programming language identifier

type: Optional[Literal["code"]]

Code block item type

Literal["blank_page", "error_message", "raw_text"]

Enum for representing the different available page error handling modes.

One of the following:

"blank_page"

"error_message"

"raw_text"

class FooterItem: …

items: List[Item]

List of items within the footer

One of the following:

class CodeItem: …

md: str

Markdown representation preserving formatting

value: str

Code content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

language: Optional[str]

Programming language identifier

type: Optional[Literal["code"]]

Code block item type

class HeadingItem: …

level: int

Heading level (1-6)

md: str

Markdown representation preserving formatting

value: str

Heading text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["heading"]]

Heading item type

class ImageItem: …

caption: str

Image caption

md: str

Markdown representation preserving formatting

url: str

URL to the image

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["image"]]

Image item type

class LinkItem: …

md: str

Markdown representation preserving formatting

text: str

Display text of the link

url: str

URL of the link

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["link"]]

Link item type

class ListItem: …

items: List[Item]

List of nested text or list items

One of the following:

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

ListItem

md: str

Markdown representation preserving formatting

ordered: bool

Whether the list is ordered or unordered

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["list"]]

List item type

class TableItem: …

csv: str

CSV representation of the table

html: str

HTML representation of the table

md: str

Markdown representation preserving formatting

rows: List[List[Union[str, float, null]]]

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

One of the following:

str

float

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

merged_from_pages: Optional[List[int]]

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

merged_into_page: Optional[int]

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

parse_concerns: Optional[List[ParseConcern]]

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

details: str

Human-readable details about the concern

type: str

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

type: Optional[Literal["table"]]

Table item type

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

md: str

Markdown representation preserving formatting

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["footer"]]

Page footer container

class Form: …

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

json: List[Json]

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

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

FormField

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

FormField

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

FormSection

FormTable

FormSection

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

FormTable

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

FormSection

FormTable

FormSection

FormTable

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

list: FormListItem

Flattened list representation of the same content

items: List[Item]

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

One of the following:

class FormListTextItem: …

One line of a form’s list representation.

md: str

Markdown representation of the line

value: str

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

type: Optional[Literal["text"]]

Text line

FormListItem

md: str

Markdown representation of this list

ordered: bool

Whether the list is ordered

type: Optional[Literal["list"]]

List node

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

FormField

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

FormField

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

class FormListItem: …

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

items: List[Item]

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

One of the following:

class FormListTextItem: …

One line of a form’s list representation.

md: str

Markdown representation of the line

value: str

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

type: Optional[Literal["text"]]

Text line

FormListItem

md: str

Markdown representation of this list

ordered: bool

Whether the list is ordered

type: Optional[Literal["list"]]

List node

class FormListTextItem: …

One line of a form’s list representation.

md: str

Markdown representation of the line

value: str

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

type: Optional[Literal["text"]]

Text line

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

FormSection

FormTable

FormSection

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

FormTable

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

FormSection

FormTable

FormSection

FormTable

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

FormField

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

FormTableCellItems

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

FormTableCellItems

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

FormTableCellItems

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

FormTableCellItems

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

FormTableCellItems

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

class HeaderItem: …

items: List[Item]

List of items within the header

One of the following:

class CodeItem: …

md: str

Markdown representation preserving formatting

value: str

Code content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

language: Optional[str]

Programming language identifier

type: Optional[Literal["code"]]

Code block item type

class HeadingItem: …

level: int

Heading level (1-6)

md: str

Markdown representation preserving formatting

value: str

Heading text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["heading"]]

Heading item type

class ImageItem: …

caption: str

Image caption

md: str

Markdown representation preserving formatting

url: str

URL to the image

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["image"]]

Image item type

class LinkItem: …

md: str

Markdown representation preserving formatting

text: str

Display text of the link

url: str

URL of the link

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["link"]]

Link item type

class ListItem: …

items: List[Item]

List of nested text or list items

One of the following:

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

ListItem

md: str

Markdown representation preserving formatting

ordered: bool

Whether the list is ordered or unordered

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["list"]]

List item type

class TableItem: …

csv: str

CSV representation of the table

html: str

HTML representation of the table

md: str

Markdown representation preserving formatting

rows: List[List[Union[str, float, null]]]

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

One of the following:

str

float

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

merged_from_pages: Optional[List[int]]

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

merged_into_page: Optional[int]

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

parse_concerns: Optional[List[ParseConcern]]

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

details: str

Human-readable details about the concern

type: str

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

type: Optional[Literal["table"]]

Table item type

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

md: str

Markdown representation preserving formatting

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["header"]]

Page header container

class HeadingItem: …

level: int

Heading level (1-6)

md: str

Markdown representation preserving formatting

value: str

Heading text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["heading"]]

Heading item type

class ImageItem: …

caption: str

Image caption

md: str

Markdown representation preserving formatting

url: str

URL to the image

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["image"]]

Image item type

class LinkItem: …

md: str

Markdown representation preserving formatting

text: str

Display text of the link

url: str

URL of the link

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["link"]]

Link item type

class ListItem: …

items: List[Item]

List of nested text or list items

One of the following:

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

ListItem

md: str

Markdown representation preserving formatting

ordered: bool

Whether the list is ordered or unordered

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["list"]]

List item type

Literal[".abw", ".awt", ".azw", 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"

class ParsingJob: …

A parse job (v1).

id: str

Unique parse job identifier

status: StatusEnum

Current job status

One of the following:

"CANCELLED"

"ERROR"

"PARTIAL_SUCCESS"

"PENDING"

"SUCCESS"

error_code: Optional[str]

Machine-readable error code when failed

error_message: Optional[str]

Human-readable error details when failed

Literal["abq", "ady", "af", 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"

Literal["parse_document_with_agent", "parse_document_with_llm", "parse_document_with_lvm", 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"

Literal["CANCELLED", "ERROR", "PARTIAL_SUCCESS", 2 more]

Enum for representing the status of a job

One of the following:

"CANCELLED"

"ERROR"

"PARTIAL_SUCCESS"

"PENDING"

"SUCCESS"

class TableItem: …

csv: str

CSV representation of the table

html: str

HTML representation of the table

md: str

Markdown representation preserving formatting

rows: List[List[Union[str, float, null]]]

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

One of the following:

str

float

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

merged_from_pages: Optional[List[int]]

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

merged_into_page: Optional[int]

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

parse_concerns: Optional[List[ParseConcern]]

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

details: str

Human-readable details about the concern

type: str

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

type: Optional[Literal["table"]]

Table item type

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

class ParsingCreateResponse: …

A parse job.

id: str

Unique parse job identifier

project_id: str

Project this job belongs to

status: Literal["CANCELLED", "COMPLETED", "FAILED", 2 more]

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

One of the following:

"CANCELLED"

"COMPLETED"

"FAILED"

"PENDING"

"RUNNING"

created_at: Optional[datetime]

Creation datetime

formatdate-time

error_message: Optional[str]

Error details when status is FAILED

name: Optional[str]

Optional display name for this parse job

tier: Optional[str]

Parsing tier used for this job

updated_at: Optional[datetime]

Update datetime

formatdate-time

usage: Optional[Usage]

Usage recorded against a job.

credits: Optional[float]

Total credits billed against this job. Null until billing has recorded it.

user_metadata: Optional[Dict[str, str]]

Key/value tags associated with this job.

class ParsingGetResponse: …

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: Job

Parse job status and metadata

id: str

Unique parse job identifier

project_id: str

Project this job belongs to

status: Literal["CANCELLED", "COMPLETED", "FAILED", 2 more]

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

One of the following:

"CANCELLED"

"COMPLETED"

"FAILED"

"PENDING"

"RUNNING"

created_at: Optional[datetime]

Creation datetime

formatdate-time

error_message: Optional[str]

Error details when status is FAILED

name: Optional[str]

Optional display name for this parse job

tier: Optional[str]

Parsing tier used for this job

updated_at: Optional[datetime]

Update datetime

formatdate-time

usage: Optional[JobUsage]

Usage recorded against a job.

credits: Optional[float]

Total credits billed against this job. Null until billing has recorded it.

user_metadata: Optional[Dict[str, str]]

Key/value tags associated with this job.

forms: Optional[Forms]

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

pages: List[FormsPage]

List of form pages or failed page entries

One of the following:

class FormsPageFormsResultPage: …

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

forms: List[Form]

Forms detected on the page

json: List[Json]

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

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

FormField

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

FormField

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

FormSection

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

FormSection

FormTable

FormSection

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

class FormTable: …

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

rows: List[List[Optional[Row]]]

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:

str

class FormTableCellItems: …

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

items: List[Item]

Form nodes inside the cell

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

FormField

FormSection

FormTable

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

FormTable

class FormSection: …

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

items: List[Item]

Child form nodes in reading order

One of the following:

class FormField: …

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

field: Literal["checkbox", "multi_select", "signature", 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[str]

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

bbox: Optional[List[BBox]]

Bounding boxes of the field’s fillable area on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

is_empty: Optional[bool]

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

label: Optional[str]

Printed field caption, if any

type: Optional[Literal["field"]]

Form field node

value: Optional[Union[str, bool, null]]

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:

str

bool

value_items: Optional[List[ValueItem]]

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

One of the following:

FormField

FormSection

FormTable

FormSection

FormTable

id: Optional[str]

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

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

FormTable

id: Optional[str]

Identifier printed on the form, if any

bbox: Optional[List[BBox]]

Bounding boxes of the table’s fillable regions on the page.

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

columns: Optional[List[str]]

Printed column headers in order, if any

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

list: FormListItem

Flattened list representation of the same content

items: List[Item]

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

One of the following:

class FormListTextItem: …

One line of a form’s list representation.

md: str

Markdown representation of the line

value: str

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

type: Optional[Literal["text"]]

Text line

FormListItem

md: str

Markdown representation of this list

ordered: bool

Whether the list is ordered

type: Optional[Literal["list"]]

List node

page_number: int

Page number of the document

success: Literal[true]

Success indicator

page_height: Optional[float]

Height of the page in points

page_width: Optional[float]

Width of the page in points

class FormsPageFailedFormsPage: …

A page whose processing failed.

error: str

Error message describing the failure

page_number: int

Page number of the document

success: Literal[false]

Failure indicator

images_content_metadata: Optional[ImagesContentMetadata]

Metadata for all extracted images.

images: List[ImagesContentMetadataImage]

List of image metadata with presigned URLs

filename: str

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

index: int

Index of the image in the extraction order

bbox: Optional[ImagesContentMetadataImageBbox]

Bounding box for an image on its page.

h: int

Height of the bounding box

w: int

Width of the bounding box

x: int

X coordinate of the bounding box

y: int

Y coordinate of the bounding box

category: Optional[Literal["embedded", "layout", "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[str]

MIME type of the image

presigned_url: Optional[str]

Presigned URL to download the image

Deprecatedsize_bytes: Optional[int]

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

total_count: int

Total number of extracted images

items: Optional[Items]

Structured JSON result (if requested)

pages: List[ItemsPage]

List of structured pages or failed page entries

One of the following:

class ItemsPageStructuredResultPage: …

Successfully parsed page in structured items output.

items: List[ItemsPageStructuredResultPageItem]

List of structured items on the page

One of the following:

class CodeItem: …

md: str

Markdown representation preserving formatting

value: str

Code content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

language: Optional[str]

Programming language identifier

type: Optional[Literal["code"]]

Code block item type

class FooterItem: …

items: List[Item]

List of items within the footer

One of the following:

class CodeItem: …

md: str

Markdown representation preserving formatting

value: str

Code content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

language: Optional[str]

Programming language identifier

type: Optional[Literal["code"]]

Code block item type

class HeadingItem: …

level: int

Heading level (1-6)

md: str

Markdown representation preserving formatting

value: str

Heading text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["heading"]]

Heading item type

class ImageItem: …

caption: str

Image caption

md: str

Markdown representation preserving formatting

url: str

URL to the image

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["image"]]

Image item type

class LinkItem: …

md: str

Markdown representation preserving formatting

text: str

Display text of the link

url: str

URL of the link

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["link"]]

Link item type

class ListItem: …

items: List[Item]

List of nested text or list items

One of the following:

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

ListItem

md: str

Markdown representation preserving formatting

ordered: bool

Whether the list is ordered or unordered

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["list"]]

List item type

class TableItem: …

csv: str

CSV representation of the table

html: str

HTML representation of the table

md: str

Markdown representation preserving formatting

rows: List[List[Union[str, float, null]]]

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

One of the following:

str

float

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

merged_from_pages: Optional[List[int]]

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

merged_into_page: Optional[int]

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

parse_concerns: Optional[List[ParseConcern]]

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

details: str

Human-readable details about the concern

type: str

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

type: Optional[Literal["table"]]

Table item type

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

md: str

Markdown representation preserving formatting

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["footer"]]

Page footer container

class HeaderItem: …

items: List[Item]

List of items within the header

One of the following:

class CodeItem: …

md: str

Markdown representation preserving formatting

value: str

Code content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

language: Optional[str]

Programming language identifier

type: Optional[Literal["code"]]

Code block item type

class HeadingItem: …

level: int

Heading level (1-6)

md: str

Markdown representation preserving formatting

value: str

Heading text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["heading"]]

Heading item type

class ImageItem: …

caption: str

Image caption

md: str

Markdown representation preserving formatting

url: str

URL to the image

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["image"]]

Image item type

class LinkItem: …

md: str

Markdown representation preserving formatting

text: str

Display text of the link

url: str

URL of the link

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["link"]]

Link item type

class ListItem: …

items: List[Item]

List of nested text or list items

One of the following:

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

ListItem

md: str

Markdown representation preserving formatting

ordered: bool

Whether the list is ordered or unordered

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["list"]]

List item type

class TableItem: …

csv: str

CSV representation of the table

html: str

HTML representation of the table

md: str

Markdown representation preserving formatting

rows: List[List[Union[str, float, null]]]

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

One of the following:

str

float

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

merged_from_pages: Optional[List[int]]

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

merged_into_page: Optional[int]

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

parse_concerns: Optional[List[ParseConcern]]

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

details: str

Human-readable details about the concern

type: str

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

type: Optional[Literal["table"]]

Table item type

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

md: str

Markdown representation preserving formatting

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["header"]]

Page header container

class HeadingItem: …

level: int

Heading level (1-6)

md: str

Markdown representation preserving formatting

value: str

Heading text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["heading"]]

Heading item type

class ImageItem: …

caption: str

Image caption

md: str

Markdown representation preserving formatting

url: str

URL to the image

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["image"]]

Image item type

class LinkItem: …

md: str

Markdown representation preserving formatting

text: str

Display text of the link

url: str

URL of the link

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["link"]]

Link item type

class ListItem: …

items: List[Item]

List of nested text or list items

One of the following:

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

ListItem

md: str

Markdown representation preserving formatting

ordered: bool

Whether the list is ordered or unordered

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["list"]]

List item type

class TableItem: …

csv: str

CSV representation of the table

html: str

HTML representation of the table

md: str

Markdown representation preserving formatting

rows: List[List[Union[str, float, null]]]

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

One of the following:

str

float

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

merged_from_pages: Optional[List[int]]

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

merged_into_page: Optional[int]

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

parse_concerns: Optional[List[ParseConcern]]

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

details: str

Human-readable details about the concern

type: str

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

type: Optional[Literal["table"]]

Table item type

class TextItem: …

md: str

Markdown representation preserving formatting

value: str

Text content

bbox: Optional[List[BBox]]

List of bounding boxes

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

confidence: Optional[float]

Confidence score

end_index: Optional[int]

End index in the text

label: Optional[str]

Label for the bounding box

r: Optional[float]

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

start_index: Optional[int]

Start index in the text

type: Optional[Literal["text"]]

Text item type

page_height: float

Height of the page in points

page_number: int

Page number of the document

page_width: float

Width of the page in points

success: Literal[true]

Success indicator

revisions: Optional[List[ItemsPageStructuredResultPageRevision]]

Extracted revisions and comments on the page

content: str

Revision or comment content

revision_bbox: ItemsPageStructuredResultPageRevisionRevisionBbox

Bounding box of the printed revision balloon

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

target: str

Best available target text in the page content

target_bbox: ItemsPageStructuredResultPageRevisionTargetBbox

Union bounding box of the target spans

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

type: Literal["comment", "deleted", "formatted", 3 more]

Type of revision

One of the following:

"comment"

"deleted"

"formatted"

"inserted"

"moved_from"

"moved_to"

author: Optional[str]

Revision author, when available

end_index: Optional[int]

Exclusive end offset in final page markdown

minimum0

start_index: Optional[int]

Inclusive start offset in final page markdown

minimum0

target_spans: Optional[List[ItemsPageStructuredResultPageRevisionTargetSpan]]

Disconnected target spans, when present

target: str

Text covered by this target span

target_bbox: ItemsPageStructuredResultPageRevisionTargetSpanTargetBbox

Bounding box of this target span

h: float

Height of the bounding box

w: float

Width of the bounding box

x: float

X coordinate of the bounding box

y: float

Y coordinate of the bounding box

end_index: Optional[int]

Exclusive end offset in final page markdown

minimum0

start_index: Optional[int]

Inclusive start offset in final page markdown

minimum0

class ItemsPageFailedStructuredPage: …

error: str

Error message describing the failure

page_number: int

Page number of the document

success: Literal[false]

Failure indicator

job_metadata: Optional[Dict[str, object]]

Job execution metadata (if requested)

markdown: Optional[Markdown]

Markdown result (if requested)

pages: List[MarkdownPage]

List of markdown pages or failed page entries

One of the following:

class MarkdownPageMarkdownResultPage: …

markdown: str

Markdown content of the page

page_number: int

Page number of the document

success: Literal[true]

Success indicator

footer: Optional[str]

Footer of the page in markdown

header: Optional[str]

Header of the page in markdown

line_numbers: Optional[List[MarkdownPageMarkdownResultPageLineNumber]]

Printed line numbers linked to final page markdown

end_index: int

Zero-based exclusive UTF-16 code-unit offset in final page markdown

minimum0

line_number: str

Printed source line number

start_index: int

Zero-based inclusive UTF-16 code-unit offset in final page markdown

minimum0

class MarkdownPageFailedMarkdownPage: …

error: str

Error message describing the failure

page_number: int

Page number of the document

success: Literal[false]

Failure indicator

markdown_full: Optional[str]

Full raw markdown content (if requested)

metadata: Optional[Metadata]

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

pages: List[MetadataPage]

List of page metadata entries

page_number: int

Page number of the document

confidence: Optional[float]

Confidence score for the page parsing (0-1)

cost_optimized: Optional[bool]

Whether cost-optimized parsing was used for the page

original_orientation_angle: Optional[int]

Original orientation angle of the page in degrees

printed_page_number: Optional[str]

Printed page number as it appears in the document

slide_section_name: Optional[str]

Section name from presentation slides

speaker_notes: Optional[str]

Speaker notes from presentation slides

triggered_auto_mode: Optional[bool]

Whether auto mode was triggered for the page

document: Optional[MetadataDocument]

Document-level metadata information.

confidence: Optional[float]

Mean confidence score across pages scored by the high-effort confidence judge (0-1)

confidence_breakdown: Optional[MetadataDocumentConfidenceBreakdown]

Coverage and worst-page details for document confidence.

min_page_score: float

Lowest confidence score among pages scored by the high-effort confidence judge

scored_pages: int

Number of pages successfully scored by the high-effort confidence judge

total_pages: int

Total number of pages in the parsed document

raw_parameters: Optional[Dict[str, object]]

result_content_metadata: Optional[Dict[str, ResultContentMetadata]]

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

size_bytes: int

Size of the result file in bytes

exists: Optional[bool]

Whether the result file exists in S3

presigned_url: Optional[str]

Presigned URL to download the result file

text: Optional[Text]

Plain text result (if requested)

pages: List[TextPage]

List of text pages

page_number: int

Page number of the document

text: str

Plain text content of the page

text_full: Optional[str]

Full raw text content (if requested)

class ParsingListResponse: …

A parse job.

id: str

Unique parse job identifier

project_id: str

Project this job belongs to

status: Literal["CANCELLED", "COMPLETED", "FAILED", 2 more]

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

One of the following:

"CANCELLED"

"COMPLETED"

"FAILED"

"PENDING"

"RUNNING"

created_at: Optional[datetime]

Creation datetime

formatdate-time

error_message: Optional[str]

Error details when status is FAILED

name: Optional[str]

Optional display name for this parse job

tier: Optional[str]

Parsing tier used for this job

updated_at: Optional[datetime]

Update datetime

formatdate-time

usage: Optional[Usage]

Usage recorded against a job.

credits: Optional[float]

Total credits billed against this job. Null until billing has recorded it.

user_metadata: Optional[Dict[str, str]]

Key/value tags associated with this job.

class ParsingCancelResponse: …

A parse job.

id: str

Unique parse job identifier

project_id: str

Project this job belongs to

status: Literal["CANCELLED", "COMPLETED", "FAILED", 2 more]

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

One of the following:

"CANCELLED"

"COMPLETED"

"FAILED"

"PENDING"

"RUNNING"

created_at: Optional[datetime]

Creation datetime

formatdate-time

error_message: Optional[str]

Error details when status is FAILED

name: Optional[str]

Optional display name for this parse job

tier: Optional[str]

Parsing tier used for this job

updated_at: Optional[datetime]

Update datetime

formatdate-time

usage: Optional[Usage]

Usage recorded against a job.

credits: Optional[float]

Total credits billed against this job. Null until billing has recorded it.

user_metadata: Optional[Dict[str, str]]

Key/value tags associated with this job.

class ParsingDeleteResponse: …

Confirmation that a parse job was deleted.

A deleted job can no longer be fetched, so the response echoes back what it was rather than pointing at it. Returning the identifiers instead of an empty body lets a caller assert on the delete it just made without a follow-up request.

id: str

Identifier of the deleted parse job

project_id: str

Project the deleted job belonged to

class ParsingListVersionsResponse: …

Versions accepted by the parse API, grouped by tier.

agentic: List[Literal["2026-09-09", "2026-09-07", "2026-08-19", 42 more]]

Versions for the agentic tier

One of the following:

"2026-09-09"

"2026-09-07"

"2026-08-19"

"2026-07-24"

"2026-07-23"

"2026-07-15"

"2026-06-18"

"2026-06-11"

"2026-06-04"

"2026-06-01"

"2026-05-26"

"2026-05-21"

"2026-05-20"

"2026-05-19"

"2026-05-13"

"2026-05-11"

"2026-05-06"

"2026-05-04"

"2026-04-27"

"2026-04-22"

"2026-04-09"

"2026-04-06"

"2026-04-02"

"2026-03-31"

"2026-03-30"

"2026-03-27"

"2026-03-25"

"2026-03-23"

"2026-03-22"

"2026-03-20"

"2026-03-11"

"2026-03-10"

"2026-03-09"

"2026-03-03"

"2026-03-02"

"2026-02-26"

"2026-02-24"

"2026-01-30"

"2026-01-22"

"2026-01-21"

"2026-01-16"

"2026-01-08"

"2025-12-31"

"2025-12-18"

"2025-12-11"

agentic_plus: List[Literal["2026-08-19", "2026-07-08", "2026-06-18", 37 more]]

Versions for the agentic_plus tier

One of the following:

"2026-08-19"

"2026-07-08"

"2026-06-18"

"2026-06-11"

"2026-06-04"

"2026-06-01"

"2026-05-26"

"2026-05-21"

"2026-05-20"

"2026-05-19"

"2026-05-11"

"2026-05-06"

"2026-05-04"

"2026-05-01"

"2026-04-27"

"2026-04-19"

"2026-04-14"

"2026-04-09"

"2026-04-02"

"2026-03-31"

"2026-03-26"

"2026-03-25"

"2026-03-22"

"2026-03-20"

"2026-03-17"

"2026-03-12"

"2026-03-10"

"2026-03-09"

"2026-03-02"

"2026-02-26"

"2026-02-24"

"2026-01-30"

"2026-01-29"

"2026-01-24"

"2026-01-22"

"2026-01-21"

"2026-01-16"

"2025-12-31"

"2025-12-18"

"2025-12-11"

cost_effective: List[Literal["2026-08-19", "2026-08-11", "2026-08-08", 12 more]]

Versions for the cost_effective tier

One of the following:

"2026-08-19"

"2026-08-11"

"2026-08-08"

"2026-07-23"

"2026-06-26"

"2026-06-18"

"2026-06-17"

"2026-06-11"

"2026-06-08"

"2026-06-05"

"2026-05-28"

"2026-04-09"

"2026-03-31"

"2026-03-27"

"2026-03-25"

fast: List[Literal["2026-06-15", "2025-12-11"]]

Versions for the fast tier

One of the following:

"2026-06-15"

"2025-12-11"

latest: Latest

Version latest currently resolves to, per tier

agentic: str

Version latest resolves to for the agentic tier

agentic_plus: str

Version latest resolves to for the agentic_plus tier

cost_effective: str

Version latest resolves to for the cost_effective tier

fast: str

Version latest resolves to for the fast tier