Parse response format

Read Markdown or elements from a completed Parse response, interpret element confidence scores, and follow progress when a request is still pending.

Parse returns document content for your application. Read the output after processing completes to confirm the content your application will consume.

Read parsed content

Read each element’s type, text, and metadata.page_number. The captured example below contains nine elements from one page.

Choose a representation

The OpenAPI contract defaults output to markdown. Request elements for individual document elements; the captured response then returns markdown: null. See Parse parameters.

Read Parse confidence

With output=elements, an element’s metadata.parse_confidence can contain a number from 0 to 1, rounded to four decimal places. The score measures how closely the element text agrees with optical character recognition (OCR) text. It is not a probability that the text is correct.

A null or missing value means the score is unavailable, not zero. Receiving a score does not require an include option. Extract does not return this score for extracted fields.

Handle an accepted request

HTTP 202 means the request is still running. Keep the complete Location URL and follow request progress. The endpoint reference includes schemas for pending responses.

See asynchronous processing for progress and Extract to request structured fields.

Captured response

The demo script produced this HTTP 200 response on September 9, 2026 from a fictional invoice. Example UUIDs replace the job IDs. The response passed the schema check against the saved API specification.

{
  "id": "11111111-1111-4111-8111-111111111111",
  "status": "completed",
  "profile": "balanced",
  "markdown": null,
  "format_version": "2.0",
  "metadata": {
    "page_count": 1
  },
  "extracted_data": [],
  "warnings": [],
  "elements": [
    {
      "element_id": "d64bd09fafbdcf88ec5ec8f063fe9775",
      "type": "Title",
      "text": "SYNTHETIC TEST INVOICE",
      "metadata": {
        "page_number": 1,
        "coordinates": null,
        "text_as_html": null
      }
    },
    {
      "element_id": "a25cbc192e0bdd517d829e9c29aa32da",
      "type": "NarrativeText",
      "text": "Invoice number: DEMO-001",
      "metadata": {
        "page_number": 1,
        "coordinates": null,
        "text_as_html": null
      }
    },
    {
      "element_id": "74463288dd65014cfb279193410876bc",
      "type": "NarrativeText",
      "text": "Seller: Example Seller",
      "metadata": {
        "page_number": 1,
        "coordinates": null,
        "text_as_html": null
      }
    },
    {
      "element_id": "464c724fdb8d81a7b2475ea6ab93683f",
      "type": "NarrativeText",
      "text": "Buyer: Example Buyer",
      "metadata": {
        "page_number": 1,
        "coordinates": null,
        "text_as_html": null
      }
    },
    {
      "element_id": "ed7357039dc52b65406ccd68155352ae",
      "type": "NarrativeText",
      "text": "Item: Test notebook",
      "metadata": {
        "page_number": 1,
        "coordinates": null,
        "text_as_html": null
      }
    },
    {
      "element_id": "7a8013c89bece182838ec50f06022ec3",
      "type": "NarrativeText",
      "text": "Quantity: 2",
      "metadata": {
        "page_number": 1,
        "coordinates": null,
        "text_as_html": null
      }
    },
    {
      "element_id": "e62d929718fd713251aeb2a1ea28cbb4",
      "type": "NarrativeText",
      "text": "Unit price: 5.00 USD",
      "metadata": {
        "page_number": 1,
        "coordinates": null,
        "text_as_html": null
      }
    },
    {
      "element_id": "949db58f4e79a45bae765f5cb0025c00",
      "type": "NarrativeText",
      "text": "Total: 10.00 USD",
      "metadata": {
        "page_number": 1,
        "coordinates": null,
        "text_as_html": null
      }
    },
    {
      "element_id": "16a40c4aa02ff980983d6db9c0222c7a",
      "type": "NarrativeText",
      "text": "This is fictional test data. No payment is due.",
      "metadata": {
        "page_number": 1,
        "coordinates": null,
        "text_as_html": null
      }
    }
  ]
}