> ## 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 Parse Jobs



## OpenAPI

````yaml /dpt3/openapi-adev2.json get /v2/parse/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/parse/jobs:
    get:
      tags:
        - Parse
      summary: ADE List Parse Jobs
      operationId: parse_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
                    description: The caller's parse jobs for this page, newest first.
                    items:
                      type: object
                      properties:
                        job_id:
                          type: string
                          description: >-
                            The unique identifier for the parse job. Format:
                            ``<service>-<26-character Crockford base32 ULID>``
                            matching
                            ``^(parse|extract)-[0-9a-hjkmnp-tv-z]{26}$``.
                            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
                          description: >-
                            The job's current status: ``pending``,
                            ``processing``, ``completed``, or ``failed``.
                        created_at:
                          type:
                            - string
                            - 'null'
                          description: ISO-8601 timestamp for when the job was created.
                        completed_at:
                          type:
                            - string
                            - 'null'
                          description: >-
                            ISO-8601 timestamp for when the job finished, if
                            terminal.
                        model_version:
                          type:
                            - string
                            - 'null'
                          description: The model snapshot used to parse the document.
                        failure_reason:
                          type:
                            - string
                            - 'null'
                          description: >-
                            The reason the job failed. Present only when
                            ``status`` is ``failed``.
                  page:
                    type: integer
                    description: The 0-indexed page number.
                  page_size:
                    type: integer
                    description: Items per page.
                  has_more:
                    type: boolean
                    description: >-
                      Whether more jobs exist beyond this page; request the next
                      ``page`` to fetch them.
        '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/parse/jobs' \
              -H 'Authorization: Bearer YOUR_API_KEY'
        - lang: Python
          label: Python
          source: |-
            import requests

            url = 'https://api.ade.landing.ai/v2/parse/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/parse/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.

````