> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landing.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ADE Get Extract Jobs

> 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}`.



## OpenAPI

````yaml /ade/va_openapi_ade2.json get /v1/ade/extract/jobs/{job_id}
openapi: 3.1.0
info:
  title: >-
    LandingAI Agentic Document Extraction (ADE) API v1: Parse, Extract,
    Classify, Split, Section
  version: 0.1.0
  description: >-
    Convert documents such as PDFs, images, and Office files into structured
    data with LandingAI's Agentic Document Extraction (ADE) v1 endpoints.
    Includes Parse (documents to Markdown and structured chunks with grounding),
    Extract (schema-based field extraction), Classify (page-level
    classification), Split (separate multi-document files), and Section
    (hierarchical table of contents), plus asynchronous jobs for parsing and
    extraction. Documentation: https://docs.landing.ai
servers:
  - url: https://api.va.landing.ai
    description: Production vision tools API
security: []
paths:
  /v1/ade/extract/jobs/{job_id}:
    get:
      tags:
        - Tools
      summary: ADE Get Extract Jobs
      description: |-
        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}`.
      operationId: tool_ade_get_extract_jobs_v1_ade_extract_jobs__job_id__get
      parameters:
        - name: job_id
          in: path
          required: true
          schema:
            type: string
            title: Job Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExtractJobStatusResponse'
        '206':
          description: >-
            Extraction completed with success but there was a schema validation
            error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExtractJobStatusResponse'
        '404':
          description: Job ID not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - Basic Auth: []
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: >-
            curl -X GET 'https://api.va.landing.ai/v1/ade/extract/jobs/{job_id}'
            \
              -H 'Authorization: Bearer YOUR_API_KEY'
        - lang: Python
          label: Python
          source: |-
            import requests

            headers = {
                'Authorization': 'Bearer YOUR_API_KEY'
            }

            url = f'https://api.va.landing.ai/v1/ade/extract/jobs/{job_id}'

            response = requests.get(url, headers=headers)
            print(response.json())
        - lang: JavaScript
          label: Node.js
          source: |-
            const axios = require('axios');

            const url = `https://api.va.landing.ai/v1/ade/extract/jobs/{jobId}`;

            axios.get(url, {
              headers: {
                'Authorization': 'Bearer YOUR_API_KEY'
              }
            })
            .then(response => console.log(response.data))
            .catch(error => console.error(error));
components:
  schemas:
    ExtractJobStatusResponse:
      properties:
        job_id:
          type: string
          title: Job Id
          description: A unique identifier for this extract job.
        status:
          type: string
          title: Status
          description: >-
            The current state of the job: `pending`, `processing`, `completed`,
            `failed`, or `cancelled`.
        received_at:
          type: integer
          title: Received At
          description: Unix timestamp (in seconds) for when the job was received.
        created_at:
          type: integer
          title: Created At
          description: Unix timestamp (in seconds) for when the job was created.
          default: 0
        progress:
          type: number
          maximum: 1
          minimum: 0
          title: Progress
          description: Job completion. Either 0.0 (not yet complete) or 1.0 (complete).
        org_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Org Id
          description: Organization ID.
        version:
          anyOf:
            - type: string
            - type: 'null'
          title: Version
          description: The exact model snapshot used for the extraction.
        data:
          anyOf:
            - $ref: '#/components/schemas/ExtractResponse'
            - type: 'null'
          description: >-
            The extraction results, returned here when the job is complete and
            you did not set an `output_save_url`. Large results are returned
            through `output_url` instead.
        output_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Output Url
          description: >-
            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:
          anyOf:
            - $ref: '#/components/schemas/ExtractMetadata'
            - type: 'null'
          description: >-
            Information about the extraction, such as the model version,
            duration, credit usage, and any schema warnings.
        failure_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Failure Reason
          description: If the job failed, a message describing what went wrong.
      type: object
      required:
        - job_id
        - status
        - received_at
        - progress
      title: ExtractJobStatusResponse
      description: The status of an extract job, plus the results once it completes.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ExtractResponse:
      properties:
        extraction:
          type: object
          title: Extraction
          description: The extracted key-value pairs.
        extraction_metadata:
          type: object
          title: Extraction Metadata
          description: The extracted key-value pairs and the chunk_reference for each one.
        metadata:
          $ref: '#/components/schemas/ExtractMetadata'
          description: The metadata for the extraction process.
      type: object
      required:
        - extraction
        - extraction_metadata
        - metadata
      title: ExtractResponse
    ExtractMetadata:
      properties:
        filename:
          type: string
          title: Filename
        org_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Org Id
        duration_ms:
          type: integer
          title: Duration Ms
        credit_usage:
          type: number
          title: Credit Usage
        job_id:
          type: string
          title: Job Id
        version:
          anyOf:
            - type: string
            - type: 'null'
          title: Version
        schema_violation_error:
          anyOf:
            - type: string
            - type: 'null'
          title: Schema Violation Error
          description: >-
            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:
          anyOf:
            - type: string
            - type: 'null'
          title: Fallback Model Version
          description: >-
            The extract model that was actually used to extract the data when
            the initial extraction attempt failed with the requested version.
        warnings:
          items:
            $ref: '#/components/schemas/ExtractWarning'
          type: array
          title: Warnings
          description: >-
            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.
      type: object
      required:
        - filename
        - org_id
        - duration_ms
        - credit_usage
        - job_id
        - version
      title: ExtractMetadata
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ExtractWarning:
      properties:
        code:
          $ref: '#/components/schemas/ExtractWarningCode'
          description: The type of warning, used to translate to a status code downstream
        msg:
          type: string
          title: Msg
          description: Human-readable description of the warning with more details
      type: object
      required:
        - code
        - msg
      title: ExtractWarning
    ExtractWarningCode:
      type: string
      enum:
        - nonconformant_schema
        - nonconformant_output
      title: ExtractWarningCode
  securitySchemes:
    Basic Auth:
      type: http
      description: >-
        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.
      scheme: bearer
      bearerFormat: Basic

````