---
title: "ADE Get Extract Jobs"
method: GET
path: "/v1/ade/extract/jobs/{job_id}"
tags: ["Tools"]
---

# ADE Get Extract Jobs

`GET /v1/ade/extract/jobs/{job_id}`

Get the status for an async extract job.

Returns the job status or an error
   response. For EU users, use this endpoint:


   `https://api.va.eu-west-1.landing.ai/v1/ade/extract/jobs/{job_id}`.

## Path parameters

- `job_id` string, required

## Response `200`

Successful Response

- ExtractJobStatusResponse — The status of an extract job, plus the results once it completes.
  - `job_id` string, required — A unique identifier for this extract job.
  - `status` string, required — The current state of the job: `pending`, `processing`, `completed`, `failed`, or `cancelled`.
  - `received_at` integer, required — Unix timestamp (in seconds) for when the job was received.
  - `created_at` integer — Unix timestamp (in seconds) for when the job was created.
  - `progress` number, required — Job completion. Either 0.0 (not yet complete) or 1.0 (complete).
  - `org_id` string, nullable — Organization ID.
  - `version` string, nullable — The exact model snapshot used for the extraction.
  - `data` ExtractResponse
    - `extraction` object, required — The extracted key-value pairs.
    - `extraction_metadata` object, required — The extracted key-value pairs and the chunk_reference for each one.
    - `metadata` ExtractMetadata, required
      - `filename` string, required
      - `org_id` string, nullable, required
      - `duration_ms` integer, required
      - `credit_usage` number, required
      - `job_id` string, required
      - `version` string, nullable, required
      - `schema_violation_error` string, nullable — A detailed error message shows why the extracted data does not fully conform to the input schema. Null means the extraction result is consistent with the input schema.
      - `fallback_model_version` string, nullable — The extract model that was actually used to extract the data when the initial extraction attempt failed with the requested version.
      - `warnings` ExtractWarning[] — Structured warnings from the extraction process. Each warning is an instance of ExtractWarning with 'code' (e.g. 'nonconformant_schema') and 'msg' (human-readable description). Present only for extract versions from extract-20260314 and above that support structured warnings.
        - `code` 'nonconformant_schema' | 'nonconformant_output', required
        - `msg` string, required — Human-readable description of the warning with more details
  - `output_url` string, nullable — A URL to download the extraction results. Provided when the job is complete and either you set an `output_save_url` or the result is larger than 1 MB. URLs for large results are temporary and expire one hour after you request the job.
  - `metadata` ExtractMetadata
    - `filename` string, required
    - `org_id` string, nullable, required
    - `duration_ms` integer, required
    - `credit_usage` number, required
    - `job_id` string, required
    - `version` string, nullable, required
    - `schema_violation_error` string, nullable — A detailed error message shows why the extracted data does not fully conform to the input schema. Null means the extraction result is consistent with the input schema.
    - `fallback_model_version` string, nullable — The extract model that was actually used to extract the data when the initial extraction attempt failed with the requested version.
    - `warnings` ExtractWarning[] — Structured warnings from the extraction process. Each warning is an instance of ExtractWarning with 'code' (e.g. 'nonconformant_schema') and 'msg' (human-readable description). Present only for extract versions from extract-20260314 and above that support structured warnings.
      - `code` 'nonconformant_schema' | 'nonconformant_output', required
      - `msg` string, required — Human-readable description of the warning with more details
  - `failure_reason` string, nullable — If the job failed, a message describing what went wrong.

## Other responses

- `206` — Extraction completed with success but there was a schema validation error.
- `404` — Job ID not found
- `422` — Validation Error

---

[API](https://skmtc.net/landing-ai/apis/landingai-agentic-document-extraction-ade-api-v2-parse-and-e.md) · [All operations](https://skmtc.net/landing-ai/apis/landingai-agentic-document-extraction-ade-api-v2-parse-and-e/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/landing-ai/landingai-agentic-document-extraction-ade-api-v2-parse-and-e/revisions/b07477df91eb/schema)