Skip to content

Get Parse Job

parsing.get(strjob_id, ParsingGetParams**kwargs) -> ParsingGetResponse
GET/api/v2/parse/{job_id}

Retrieve a parse job with optional expanded content.

By default returns job metadata only. Use expand to include parsed content:

  • text — plain text output
  • markdown — markdown output
  • items — structured page-by-page output
  • job_metadata — processing details
  • usage — credits billed against the job

Content metadata fields (e.g. text_content_metadata) return presigned URLs for downloading large results.

ParametersExpand Collapse
job_id: str
expand: Optional[Sequence[str]]

Fields to include: text, markdown, items, metadata, forms, job_metadata, usage, text_content_metadata, markdown_content_metadata, items_content_metadata, metadata_content_metadata, forms_content_metadata, raw_words_content_metadata, xlsx_content_metadata, output_pdf_content_metadata, images_content_metadata. Metadata fields include presigned URLs.

image_filenames: Optional[str]

Filter to specific image filenames (optional). Example: image_0.png,image_1.jpg

organization_id: Optional[str]
project_id: Optional[str]
ReturnsExpand Collapse
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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

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:
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 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 FormText: …

Printed text that is not part of a field, section heading or table: a title, an instruction, a note. With it the form JSON holds every printed word of its region.

value: str

The printed text, verbatim

bbox: Optional[List[BBox]]

Bounding boxes of the text on the page, if attributed.

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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

type: Optional[Literal["text"]]

Form text node

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

grounding: Optional[Grounding]

Scalar text grounding aligned with the table’s columns and ragged rows.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

columns: Optional[List[GroundingColumn]]

Column text grounding in source order; blank slots have empty lines

lines: List[GroundingColumnLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingColumnLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

rows: Optional[List[List[GroundingRow]]]

Scalar cell text grounding aligned with rows; blank and structured slots have empty lines. Structured children carry their own grounding.

lines: List[GroundingRowLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingRowLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

html: Optional[str]

HTML representation of the table, as a regular table item has.

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

class FormText: …

Printed text that is not part of a field, section heading or table: a title, an instruction, a note. With it the form JSON holds every printed word of its region.

value: str

The printed text, verbatim

bbox: Optional[List[BBox]]

Bounding boxes of the text on the page, if attributed.

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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

type: Optional[Literal["text"]]

Form text node

id: Optional[str]

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

grounding: Optional[Grounding]

Optional grounding for printed identifiers and headings.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

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 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 FormText: …

Printed text that is not part of a field, section heading or table: a title, an instruction, a note. With it the form JSON holds every printed word of its region.

value: str

The printed text, verbatim

bbox: Optional[List[BBox]]

Bounding boxes of the text on the page, if attributed.

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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

type: Optional[Literal["text"]]

Form text node

id: Optional[str]

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

grounding: Optional[Grounding]

Optional grounding for printed identifiers and headings.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[str]

Printed section heading, if any

type: Optional[Literal["section"]]

Form section node

class FormText: …

Printed text that is not part of a field, section heading or table: a title, an instruction, a note. With it the form JSON holds every printed word of its region.

value: str

The printed text, verbatim

bbox: Optional[List[BBox]]

Bounding boxes of the text on the page, if attributed.

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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

type: Optional[Literal["text"]]

Form text node

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

grounding: Optional[Grounding]

Scalar text grounding aligned with the table’s columns and ragged rows.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

columns: Optional[List[GroundingColumn]]

Column text grounding in source order; blank slots have empty lines

lines: List[GroundingColumnLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingColumnLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

rows: Optional[List[List[GroundingRow]]]

Scalar cell text grounding aligned with rows; blank and structured slots have empty lines. Structured children carry their own grounding.

lines: List[GroundingRowLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingRowLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

html: Optional[str]

HTML representation of the table, as a regular table item has.

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

class FormText: …

Printed text that is not part of a field, section heading or table: a title, an instruction, a note. With it the form JSON holds every printed word of its region.

value: str

The printed text, verbatim

bbox: Optional[List[BBox]]

Bounding boxes of the text on the page, if attributed.

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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

type: Optional[Literal["text"]]

Form text 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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

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:
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 FormText: …

Printed text that is not part of a field, section heading or table: a title, an instruction, a note. With it the form JSON holds every printed word of its region.

value: str

The printed text, verbatim

bbox: Optional[List[BBox]]

Bounding boxes of the text on the page, if attributed.

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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

type: Optional[Literal["text"]]

Form text node

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

grounding: Optional[Grounding]

Scalar text grounding aligned with the table’s columns and ragged rows.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

columns: Optional[List[GroundingColumn]]

Column text grounding in source order; blank slots have empty lines

lines: List[GroundingColumnLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingColumnLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

rows: Optional[List[List[GroundingRow]]]

Scalar cell text grounding aligned with rows; blank and structured slots have empty lines. Structured children carry their own grounding.

lines: List[GroundingRowLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingRowLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

html: Optional[str]

HTML representation of the table, as a regular table item has.

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

class FormText: …

Printed text that is not part of a field, section heading or table: a title, an instruction, a note. With it the form JSON holds every printed word of its region.

value: str

The printed text, verbatim

bbox: Optional[List[BBox]]

Bounding boxes of the text on the page, if attributed.

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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

type: Optional[Literal["text"]]

Form text 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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

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:
class FormText: …

Printed text that is not part of a field, section heading or table: a title, an instruction, a note. With it the form JSON holds every printed word of its region.

value: str

The printed text, verbatim

bbox: Optional[List[BBox]]

Bounding boxes of the text on the page, if attributed.

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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

type: Optional[Literal["text"]]

Form text node

class FormText: …

Printed text that is not part of a field, section heading or table: a title, an instruction, a note. With it the form JSON holds every printed word of its region.

value: str

The printed text, verbatim

bbox: Optional[List[BBox]]

Bounding boxes of the text on the page, if attributed.

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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

type: Optional[Literal["text"]]

Form text node

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

grounding: Optional[Grounding]

Scalar text grounding aligned with the table’s columns and ragged rows.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

columns: Optional[List[GroundingColumn]]

Column text grounding in source order; blank slots have empty lines

lines: List[GroundingColumnLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingColumnLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

rows: Optional[List[List[GroundingRow]]]

Scalar cell text grounding aligned with rows; blank and structured slots have empty lines. Structured children carry their own grounding.

lines: List[GroundingRowLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingRowLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

html: Optional[str]

HTML representation of the table, as a regular table item has.

label: Optional[str]

Printed table caption, if any

type: Optional[Literal["table"]]

Form table node

class FormText: …

Printed text that is not part of a field, section heading or table: a title, an instruction, a note. With it the form JSON holds every printed word of its region.

value: str

The printed text, verbatim

bbox: Optional[List[BBox]]

Bounding boxes of the text on the page, if attributed.

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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

value: Optional[GroundingValue]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingValueLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingValueLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

type: Optional[Literal["text"]]

Form text node

id: Optional[str]

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

grounding: Optional[Grounding]

Optional grounding for printed identifiers and headings.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

label: Optional[GroundingLabel]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingLabelLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingLabelLineWord]]

Per-word grounding within the line, when available

bbox: BBox

Word bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

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

grounding: Optional[Grounding]

Optional grounding for a field’s printed text; boolean states have no text spans.

id: Optional[GroundingID]

Supported text with half-open UTF-8 byte spans into the complete property string.

lines: List[GroundingIDLine]

Supported lines. Word requests include supported words; gaps are valid. Boxes use final page coordinates and optional local rotation r.

bbox: BBox

Line bounding box

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

span: List[object]

[start, end) UTF-8 byte span in the complete source property string

words: Optional[List[GroundingIDLineWord]]

Per-word grounding within the line, when available