> ## 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 List Extract Jobs

> List your Extract jobs, newest first.



## OpenAPI

````yaml /dpt3/openapi-adev2.json get /v2/extract/jobs
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:
    get:
      tags:
        - Extract
      summary: ADE List Extract Jobs
      description: List your Extract jobs, newest first.
      operationId: v2-extract_list_jobs
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Page number (0-indexed).
            default: 0
            title: Page
          description: Page number (0-indexed).
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Number of items per page.
            default: 10
            title: Page Size
          description: Number of items per page.
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filter by job status.
            title: Status
          description: Filter by job status.
      responses:
        '200':
          description: The caller's jobs, newest first
          content:
            application/json:
              schema:
                type: object
                properties:
                  jobs:
                    type: array
                    items:
                      type: object
                      properties:
                        job_id:
                          type: string
                          description: >-
                            The unique identifier for this v2-extract job.
                            Format: ``extract-<26-character Crockford base32
                            ULID>`` (``[0-9a-hjkmnp-tv-z]{26}`` tail). Opaque,
                            server-minted, and stable for the life of the job —
                            the same id is returned on the sync response, the
                            async 202, and every poll. Treat it as opaque; older
                            id formats remain accepted indefinitely and are
                            never re-issued.
                        status:
                          type: string
                          enum:
                            - pending
                            - processing
                            - completed
                            - failed
                        created_at:
                          type:
                            - string
                            - 'null'
                        completed_at:
                          type:
                            - string
                            - 'null'
                        model_version:
                          type:
                            - string
                            - 'null'
                        failure_reason:
                          type:
                            - string
                            - 'null'
                  page:
                    type: integer
                  page_size:
                    type: integer
                  has_more:
                    type: boolean
        '422':
          description: Request validation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: |-
            curl 'https://api.ade.landing.ai/v2/extract/jobs' \
              -H 'Authorization: Bearer YOUR_API_KEY'
        - lang: Python
          label: Python
          source: |-
            import requests

            url = 'https://api.ade.landing.ai/v2/extract/jobs'
            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', {
              headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
            })
              .then(response => console.log(response.data))
              .catch(error => console.error(error));
components:
  schemas:
    ErrorResponse:
      type: object
      title: ErrorResponse
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: >-
            Stable snake_case error code (e.g. ``validation_error``,
            ``unknown_model_version``, ``invalid_url``, ``invalid_api_key``,
            ``rate_limit_exceeded``).
        message:
          type: string
          description: Human-readable detail.

````