Skip to main content
GET
/
v1
/
ade
/
parse
/
jobs
/
{job_id}
cURL
curl -X GET 'https://api.va.landing.ai/v1/ade/parse/jobs/{job_id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "job_id": "<string>",
  "status": "<string>",
  "received_at": 123,
  "progress": 0.5,
  "org_id": "<string>",
  "version": "<string>",
  "data": {
    "markdown": "<string>",
    "chunks": [
      {
        "markdown": "<string>",
        "type": "<string>",
        "id": "<string>",
        "grounding": {
          "box": {
            "left": 123,
            "top": 123,
            "right": 123,
            "bottom": 123
          },
          "page": 123
        }
      }
    ],
    "splits": [
      {
        "class": "<string>",
        "identifier": "<string>",
        "pages": [
          123
        ],
        "markdown": "<string>",
        "chunks": [
          "<string>"
        ]
      }
    ],
    "metadata": {
      "filename": "<string>",
      "org_id": "<string>",
      "page_count": 123,
      "duration_ms": 123,
      "credit_usage": 123,
      "job_id": "<string>",
      "version": "<string>",
      "failed_pages": [
        123
      ]
    },
    "grounding": {}
  },
  "output_url": "<string>",
  "metadata": {
    "filename": "<string>",
    "org_id": "<string>",
    "page_count": 123,
    "duration_ms": 123,
    "credit_usage": 123,
    "job_id": "<string>",
    "version": "<string>",
    "failed_pages": [
      123
    ]
  },
  "failure_reason": "<string>"
}

Authorizations

​
Authorization
string
header
required

Your unique API key for authentication.

Get your API key here: https://va.landing.ai/settings/api-key.

If using the EU endpoint, get your API key here: https://va.eu-west-1.landing.ai/settings/api-key.

Path Parameters

​
job_id
string
required

Response

Successful Response

Unified response for job status endpoint.

​
job_id
string
required
​
status
string
required
​
received_at
integer
required
​
progress
number
required

Job completion progress as a decimal from 0 to 1, where 0 is not started, 1 is finished, and values between 0 and 1 indicate work in progress.

Required range: 0 <= x <= 1
​
org_id
string | null
​
version
string | null
​
data
ParseResponse · object

The parsed output (ParseResponse for documents, SpreadsheetParseResponse for spreadsheets), if the job is complete and the output_save_url parameter was not used.

  • ParseResponse
  • SpreadsheetParseResponse
​
output_url
string | null

The URL to the parsed content. This field contains a URL when the job is complete and either you specified the output_save_url parameter or the result is larger than 1MB. When the result exceeds 1MB, the URL is a presigned S3 URL that expires after 1 hour. Each time you GET the job, a new presigned URL is generated.

​
metadata
ParseMetadata · object
​
failure_reason
string | null