Get Parse Job
Retrieve a parse job with optional expanded content.
By default returns job metadata only. Use expand to include
parsed content:
text— plain text outputmarkdown— markdown outputitems— structured page-by-page outputjob_metadata— processing detailsusage— credits billed against the job
Content metadata fields (e.g. text_content_metadata) return
presigned URLs for downloading large results.
ParametersExpand Collapse
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.
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
forms: Optional[Forms]
Per-page form analysis results (one entry per page).
pages: List[FormsPage]
List of form pages or failed page entries
class FormsPageFormsResultPage: …
Forms found on one page. Pages without form content have an empty forms list.
Forms detected on the page
json: List[Json]
Structured representation: an ordered tree of sections, fields, and tables
class FormField: …
One labeled form entry: a text input, checkbox, select group, or signature line.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
value_items: Optional[List[ValueItem]]
Options of a single_select/multi_select group (only on select fields)
class FormSection: …
A grouping of form content, in the form’s reading order.
items: List[Item]
Child form nodes in reading order
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
class FormTableCellItems: …
A table cell holding its own form nodes (e.g. a checkbox column).
items: List[Item]
Form nodes inside the cell
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.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
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.
columns: Optional[List[GroundingColumn]]
Column text grounding in source order; blank slots have empty lines
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete 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.
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.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
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
class FormTableCellItems: …
A table cell holding its own form nodes (e.g. a checkbox column).
items: List[Item]
Form nodes inside the cell
class FormSection: …
A grouping of form content, in the form’s reading order.
items: List[Item]
Child form nodes in reading order
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.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
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.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
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.
columns: Optional[List[GroundingColumn]]
Column text grounding in source order; blank slots have empty lines
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete 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.
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.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
class FormSection: …
A grouping of form content, in the form’s reading order.
items: List[Item]
Child form nodes in reading order
class FormField: …
One labeled form entry: a text input, checkbox, select group, or signature line.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
value_items: Optional[List[ValueItem]]
Options of a single_select/multi_select group (only on select fields)
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
class FormTableCellItems: …
A table cell holding its own form nodes (e.g. a checkbox column).
items: List[Item]
Form nodes inside the cell
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.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
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.
columns: Optional[List[GroundingColumn]]
Column text grounding in source order; blank slots have empty lines
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete 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.
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.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
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
class FormTableCellItems: …
A table cell holding its own form nodes (e.g. a checkbox column).
items: List[Item]
Form nodes inside the cell
class FormField: …
One labeled form entry: a text input, checkbox, select group, or signature line.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
value_items: Optional[List[ValueItem]]
Options of a single_select/multi_select group (only on select fields)
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.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
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.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
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.
columns: Optional[List[GroundingColumn]]
Column text grounding in source order; blank slots have empty lines
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete 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.
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.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
value: Optional[GroundingValue]
Supported text with half-open UTF-8 byte spans into the complete property string.
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.
label: Optional[GroundingLabel]
Supported text with half-open UTF-8 byte spans into the complete property string.
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
class FormTableCellItems: …
A table cell holding its own form nodes (e.g. a checkbox column).
items: List[Item]
Form nodes inside the cell
class FormField: …
One labeled form entry: a text input, checkbox, select group, or signature line.
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.