V2
Parse

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 output
  • markdown — markdown output
  • items — structured page-by-page output
  • job_metadata — usage and processing details

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

get/api/v2/parse/{job_id}

Path parameters

job_idstring required

Query parameters

expandstring[]

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

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

image_filenamesstring nullable

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

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

project_idstring uuid nullable
organization_idstring uuid nullable

Cookies

sessionstring nullable

Response

Successful Response

result_content_metadataobject nullable

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

markdown_fullstring nullable

Full raw markdown content (if requested)

text_fullstring nullable

Full raw text content (if requested)

job_metadataobject nullable

Job execution metadata (if requested)

raw_parametersobject nullable

Changes

Changed in 3 of the 33 revisions of this API.29

    • added the optional property detail/items/ctx to the response with the 422 status

      response-optional-property-added

    • added the optional property detail/items/input to the response with the 422 status

      response-optional-property-added

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #1: TextItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #2: HeadingItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #3: ListItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #3: ListItem]/items/items/anyOf[subschema #1: TextItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #4: CodeItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #5: TableItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #6: ImageItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #7: LinkItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #8: HeaderItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #8: HeaderItem]/items/items/oneOf[subschema #1: TextItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #8: HeaderItem]/items/items/oneOf[subschema #2: HeadingItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #8: HeaderItem]/items/items/oneOf[subschema #3: ListItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #8: HeaderItem]/items/items/oneOf[subschema #3: ListItem]/items/items/anyOf[subschema #1: TextItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #8: HeaderItem]/items/items/oneOf[subschema #4: CodeItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #8: HeaderItem]/items/items/oneOf[subschema #5: TableItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #8: HeaderItem]/items/items/oneOf[subschema #6: ImageItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #8: HeaderItem]/items/items/oneOf[subschema #7: LinkItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #9: FooterItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #9: FooterItem]/items/items/oneOf[subschema #1: TextItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #9: FooterItem]/items/items/oneOf[subschema #2: HeadingItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #9: FooterItem]/items/items/oneOf[subschema #3: ListItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #9: FooterItem]/items/items/oneOf[subschema #3: ListItem]/items/items/anyOf[subschema #1: TextItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #9: FooterItem]/items/items/oneOf[subschema #4: CodeItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #9: FooterItem]/items/items/oneOf[subschema #5: TableItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #9: FooterItem]/items/items/oneOf[subschema #6: ImageItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • added the optional property items/anyOf[subschema #1: StructuredResult]/pages/items/anyOf[subschema #1: StructuredResultPage]/items/items/oneOf[subschema #9: FooterItem]/items/items/oneOf[subschema #7: LinkItem]/bbox/anyOf[subschema #1]/items/r to the response with the 200 status

      response-optional-property-added

    • response property images_content_metadata/anyOf[subschema #1: ImagesContentMetadata]/images/items/size_bytes deprecated

      response-property-deprecated