Parse response format

Read Markdown or individual elements from a completed Parse response. Inspect a captured example and follow progress when a request is 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.

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
      }
    }
  ]
}