> ## 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 of an async Extract job, including its result once the job has completed.



## OpenAPI

````yaml /dpt3/openapi-adev2.json get /v2/extract/jobs/{job_id}
openapi: 3.1.0
info:
  title: >-
    LandingAI Agentic Document Extraction (ADE) API v2: Parse and Extract
    Documents with DPT-3
  description: >-
    Parse and extract data from documents with DPT-3, a document parsing model
    from LandingAI, using the Agentic Document Extraction (ADE) v2 endpoints.
    Parse converts PDFs and images into structured Markdown and elements with
    per-element grounding (page numbers and coordinates) for RAG, search, and
    extraction pipelines. Extract pulls specific fields from parsed Markdown
    using a JSON schema. Documentation: https://docs.landing.ai
  version: 1.0.0
servers:
  - url: https://api.ade.landing.ai
    description: Production vision tools API
security: []
paths:
  /v2/extract/jobs/{job_id}:
    get:
      tags:
        - Extract
      summary: ADE Get Extract Jobs
      description: >-
        Get the status of an async Extract job, including its result once the
        job has completed.
      operationId: v2-extract_get_job
      parameters:
        - name: job_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              The identifier of the job to retrieve, as returned by the
              create-job request.
            title: Job Id
          description: >-
            The identifier of the job to retrieve, as returned by the create-job
            request.
      responses:
        '200':
          description: Job status / result
          content:
            application/json:
              schema:
                type: object
                properties:
                  job_id:
                    type: string
                  status:
                    type: string
                    enum:
                      - pending
                      - processing
                      - completed
                      - failed
                  created_at:
                    type:
                      - string
                      - 'null'
                  completed_at:
                    type: string
                    description: Present once the job is terminal.
                  progress:
                    description: >-
                      Best-effort progress, present while processing only for
                      jobs that report it.
                  result:
                    anyOf:
                      - description: >-
                          Result returned by V2ExtractOperationWorkflow — the
                          ``/v2/extract``

                          response body (``docs/extract-v2-proposal.md`` →
                          Response).


                          ``extraction`` and ``extraction_metadata`` mirror each
                          other structurally:

                          leaf values in ``extraction`` are replaced by
                          ``ExtractionFieldMetadata``

                          objects in ``extraction_metadata``.
                        properties:
                          extraction:
                            additionalProperties: true
                            description: >-
                              Extracted values conforming to the request
                              ``schema``.
                            title: Extraction
                            type: object
                          extraction_metadata:
                            additionalProperties: true
                            description: >-
                              Per-field metadata, mirroring ``extraction`` with
                              leaf values replaced by ``{value, spans}``
                              objects.
                            title: Extraction Metadata
                            type: object
                          markdown:
                            description: Echoed input markdown.
                            title: Markdown
                            type: string
                          metadata:
                            $ref: '#/components/schemas/V2ExtractMetadata'
                            description: >-
                              Request metadata (job_id, version, duration_ms,
                              doc_id, credit_usage).
                        required:
                          - extraction
                          - extraction_metadata
                          - markdown
                          - metadata
                        title: V2ExtractResult
                        type: object
                      - type: 'null'
                    description: Present once status is ``completed``.
                  error:
                    type: object
                    description: Present once status is ``failed``.
                    properties:
                      code:
                        type: string
                        description: Stable error code (``internal_error`` when unmapped).
                      message:
                        type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: |-
            curl 'https://api.ade.landing.ai/v2/extract/jobs/JOB_ID' \
              -H 'Authorization: Bearer YOUR_API_KEY'
        - lang: Python
          label: Python
          source: |-
            import requests

            url = 'https://api.ade.landing.ai/v2/extract/jobs/JOB_ID'
            headers = {'Authorization': 'Bearer YOUR_API_KEY'}

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

            axios.get('https://api.ade.landing.ai/v2/extract/jobs/JOB_ID', {
              headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
            })
              .then(response => console.log(response.data))
              .catch(error => console.error(error));
components:
  schemas:
    V2ExtractMetadata:
      description: Response metadata for a v2 extract call.
      properties:
        job_id:
          description: >-
            Gateway job id (workflow id). Matches the ``x-request-id`` the
            gateway minted for this request and the billing row id in
            vision-agent.
          title: Job Id
          type: string
        version:
          description: Resolved model version.
          title: Version
          type: string
        duration_ms:
          description: End-to-end request duration in milliseconds.
          title: Duration Ms
          type: integer
        doc_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            Present when the input markdown contained a ``<!-- doc_id=<id> -->``
            comment (embedded by ``POST /v2/parse``). Links this extract call to
            the originating parse job.
          title: Doc Id
        credit_usage:
          default: 0
          description: Credits billed for this request.
          title: Credit Usage
          type: number
        billing:
          anyOf:
            - $ref: '#/components/schemas/V2Billing'
            - type: 'null'
          description: >-
            Billing summary: the service tier the request ran in and the credits
            charged.
      required:
        - job_id
        - version
        - duration_ms
      title: V2ExtractMetadata
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    V2Billing:
      description: |-
        Billing summary: the service tier the request ran in and the credits
        charged.
      properties:
        service_tier:
          anyOf:
            - enum:
                - standard
                - priority
              type: string
            - type: 'null'
          default: null
          description: >-
            The service tier the request ran in: `standard` or `priority`. A
            sync request reports `priority` (same lane, same price).
          title: Service Tier
        total_credits:
          anyOf:
            - type: number
            - type: 'null'
          default: null
          description: Credits charged for this request.
          title: Total Credits
      title: V2Billing
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````