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

> Get the status for an async parse 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/parse/jobs/{job_id}`.



## OpenAPI

````yaml /ade/va_openapi_ade2.json get /v1/ade/parse/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/parse/jobs/{job_id}:
    get:
      tags:
        - Tools
      summary: ADE Get Parse Jobs
      description: |-
        Get the status for an async parse 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/parse/jobs/{job_id}`.
      operationId: tool_ade_get_parse_jobs_v1_ade_parse_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/JobStatusResponse'
        '206':
          description: There were some pages that failed to be parsed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatusResponse'
        '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/parse/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/parse/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/parse/jobs/{jobId}`;

            axios.get(url, {
              headers: {
                'Authorization': 'Bearer YOUR_API_KEY'
              }
            })
            .then(response => console.log(response.data))
            .catch(error => console.error(error));
components:
  schemas:
    JobStatusResponse:
      properties:
        job_id:
          type: string
          title: Job Id
        status:
          type: string
          title: Status
        received_at:
          type: integer
          title: Received At
        created_at:
          type: integer
          title: Created At
          description: >-
            Unix timestamp (seconds) for when the job was created. Mirrors
            received_at; exposed so clients have an explicit creation time.
          default: 0
        progress:
          type: number
          maximum: 1
          minimum: 0
          title: Progress
          description: >-
            Job completion progress as a decimal from 0 to 1, where 0 is not
            started, 1 is finished, and values between 0 and 1 indicate work in
            progress.
        org_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Org Id
        version:
          anyOf:
            - type: string
            - type: 'null'
          title: Version
        data:
          anyOf:
            - $ref: '#/components/schemas/ParseResponse'
            - $ref: '#/components/schemas/SpreadsheetParseResponse'
            - type: 'null'
          title: Data
          description: >-
            The parsed output (ParseResponse for documents,
            SpreadsheetParseResponse for spreadsheets), if the job is complete
            and the `output_save_url` parameter was not used.
        output_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Output Url
          description: >-
            The URL to the parsed content. This field contains a URL when the
            job is complete and either you specified the `output_save_url`
            parameter or the result is larger than 1MB. When the result exceeds
            1MB, the URL is a presigned S3 URL that expires after 1 hour. Each
            time you GET the job, a new presigned URL is generated.
        metadata:
          anyOf:
            - $ref: '#/components/schemas/ParseMetadata'
            - type: 'null'
        failure_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Failure Reason
      type: object
      required:
        - job_id
        - status
        - received_at
        - progress
      title: JobStatusResponse
      description: Unified response for job status endpoint.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ParseResponse:
      properties:
        markdown:
          type: string
          title: Markdown
        chunks:
          items:
            $ref: '#/components/schemas/ParseChunk'
          type: array
          title: Chunks
        splits:
          items:
            $ref: '#/components/schemas/ParseSplit'
          type: array
          title: Splits
        grounding:
          additionalProperties:
            anyOf:
              - $ref: '#/components/schemas/ParseResponseGrounding'
              - $ref: '#/components/schemas/ParseResponseTableCellGrounding'
          type: object
          title: Grounding
        metadata:
          $ref: '#/components/schemas/ParseMetadata'
      type: object
      required:
        - markdown
        - chunks
        - splits
        - metadata
      title: ParseResponse
    SpreadsheetParseResponse:
      properties:
        markdown:
          type: string
          title: Markdown
          description: Full document as HTML with anchor tags and tables
        chunks:
          items:
            $ref: '#/components/schemas/SpreadsheetChunk'
          type: array
          title: Chunks
          description: List of table chunks (HTML)
        splits:
          items:
            $ref: '#/components/schemas/SpreadsheetSplit'
          type: array
          title: Splits
          description: Sheet-based splits
        metadata:
          $ref: '#/components/schemas/SpreadsheetParseMetadata'
          description: Parsing metadata
      type: object
      required:
        - markdown
        - chunks
        - splits
        - metadata
      title: SpreadsheetParseResponse
      description: |-
        Response from /ade/parse-spreadsheet endpoint.

        Similar structure to ParseResponse but without grounding.
    ParseMetadata:
      properties:
        filename:
          type: string
          title: Filename
        org_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Org Id
        page_count:
          type: integer
          title: Page Count
        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
        failed_pages:
          items:
            type: integer
          type: array
          title: Failed Pages
      type: object
      required:
        - filename
        - org_id
        - page_count
        - duration_ms
        - credit_usage
        - job_id
        - version
      title: ParseMetadata
    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
    ParseChunk:
      properties:
        markdown:
          type: string
          title: Markdown
        type:
          type: string
          title: Type
        id:
          type: string
          title: Id
        grounding:
          $ref: '#/components/schemas/ParseGrounding'
      type: object
      required:
        - markdown
        - type
        - id
        - grounding
      title: ParseChunk
    ParseSplit:
      properties:
        class:
          type: string
          title: Class
        identifier:
          type: string
          title: Identifier
        pages:
          items:
            type: integer
          type: array
          title: Pages
        markdown:
          type: string
          title: Markdown
        chunks:
          items:
            type: string
          type: array
          title: Chunks
      type: object
      required:
        - class
        - identifier
        - pages
        - markdown
        - chunks
      title: ParseSplit
    ParseResponseGrounding:
      properties:
        box:
          $ref: '#/components/schemas/ParseGroundingBox'
        page:
          type: integer
          title: Page
        type:
          $ref: '#/components/schemas/GroundingType'
        confidence:
          anyOf:
            - type: number
            - type: 'null'
          title: Confidence
        low_confidence_spans:
          items:
            $ref: '#/components/schemas/Patch'
          type: array
          title: Low Confidence Spans
      type: object
      required:
        - box
        - page
        - type
      title: ParseResponseGrounding
    ParseResponseTableCellGrounding:
      properties:
        box:
          $ref: '#/components/schemas/ParseGroundingBox'
        page:
          type: integer
          title: Page
        type:
          $ref: '#/components/schemas/GroundingType'
        confidence:
          anyOf:
            - type: number
            - type: 'null'
          title: Confidence
        position:
          anyOf:
            - $ref: '#/components/schemas/ParseResponseTableCellGroundingPosition'
            - type: 'null'
      type: object
      required:
        - box
        - page
        - type
      title: ParseResponseTableCellGrounding
    SpreadsheetChunk:
      properties:
        markdown:
          type: string
          title: Markdown
          description: >-
            Chunk content as HTML table with anchor tag (for tables) or parsed
            markdown content (for chunks from images)
        type:
          type: string
          title: Type
          description: >-
            Chunk type: 'table' for spreadsheet tables, or types from /parse
            (text, table, figure, form, etc.) for chunks derived from embedded
            images
        id:
          type: string
          title: Id
          description: >-
            Chunk ID - format: '{sheet_name}-{cell_range}' for tables,
            '{sheet_name}-image-{index}-{anchor_cell}-chunk-{i}-{type}' for
            parsed image chunks
        grounding:
          anyOf:
            - $ref: '#/components/schemas/ParseGrounding'
            - type: 'null'
          description: >-
            Visual grounding coordinates from /parse API (only for chunks
            derived from embedded images)
      type: object
      required:
        - markdown
        - type
        - id
      title: SpreadsheetChunk
      description: |-
        Chunk from spreadsheet parsing.

        Can represent:
        - Table chunks from spreadsheet cells
        - Parsed content chunks from embedded images (text, table, figure, etc.)
    SpreadsheetSplit:
      properties:
        class:
          type: string
          title: Class
          description: >-
            Split class: 'page' for per-sheet splits, 'full' for single split
            with all content
        identifier:
          type: string
          title: Identifier
          description: >-
            Split identifier: sheet name for 'page' splits, 'full' for full
            split
        sheets:
          items:
            type: integer
          type: array
          title: Sheets
          description: >-
            Sheet indices: single element for 'page' splits, all indices for
            'full' split
        markdown:
          type: string
          title: Markdown
          description: Combined markdown for this split
        chunks:
          items:
            type: string
          type: array
          title: Chunks
          description: Chunk IDs in this split
      type: object
      required:
        - class
        - identifier
        - sheets
        - markdown
        - chunks
      title: SpreadsheetSplit
      description: |-
        Sheet-based split from spreadsheet parsing.

        Similar to ParseSplit but grouped by sheet instead of page.
        Supports both 'page' (per-sheet) and 'full' (all sheets) split types.
    SpreadsheetParseMetadata:
      properties:
        filename:
          type: string
          title: Filename
          description: Original filename
        org_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Org Id
          description: Organization ID
        sheet_count:
          type: integer
          title: Sheet Count
          description: Number of sheets processed
        total_rows:
          type: integer
          title: Total Rows
          description: Total rows across all sheets
        total_cells:
          type: integer
          title: Total Cells
          description: Total non-empty cells across all sheets
        total_chunks:
          type: integer
          title: Total Chunks
          description: Total chunks (tables + images) extracted
        total_images:
          type: integer
          title: Total Images
          description: Total images extracted
          default: 0
        duration_ms:
          type: integer
          title: Duration Ms
          description: Processing duration in milliseconds
        credit_usage:
          type: number
          title: Credit Usage
          description: Credits charged
          default: 0
        job_id:
          type: string
          title: Job Id
          description: Inference history job ID
          default: ''
        version:
          anyOf:
            - type: string
            - type: 'null'
          title: Version
          description: Model version for parsing images
      type: object
      required:
        - filename
        - sheet_count
        - total_rows
        - total_cells
        - total_chunks
        - duration_ms
      title: SpreadsheetParseMetadata
      description: Metadata for spreadsheet parsing result.
    ParseGrounding:
      properties:
        box:
          $ref: '#/components/schemas/ParseGroundingBox'
        page:
          type: integer
          title: Page
      type: object
      required:
        - box
        - page
      title: ParseGrounding
    ParseGroundingBox:
      properties:
        left:
          type: number
          title: Left
        top:
          type: number
          title: Top
        right:
          type: number
          title: Right
        bottom:
          type: number
          title: Bottom
      type: object
      required:
        - left
        - top
        - right
        - bottom
      title: ParseGroundingBox
    GroundingType:
      type: string
      enum:
        - chunkLogo
        - chunkCard
        - chunkAttestation
        - chunkScanCode
        - chunkForm
        - chunkTable
        - chunkFigure
        - chunkText
        - chunkMarginalia
        - chunkTitle
        - chunkPageHeader
        - chunkPageFooter
        - chunkPageNumber
        - chunkKeyValue
        - table
        - tableCell
      title: GroundingType
    Patch:
      properties:
        text:
          type: string
          title: Text
        span:
          prefixItems:
            - type: integer
            - type: integer
          type: array
          maxItems: 2
          minItems: 2
          title: Span
        confidence:
          type: number
          title: Confidence
      type: object
      required:
        - text
        - span
        - confidence
      title: Patch
    ParseResponseTableCellGroundingPosition:
      properties:
        row:
          type: integer
          title: Row
        col:
          type: integer
          title: Col
        rowspan:
          type: integer
          title: Rowspan
        colspan:
          type: integer
          title: Colspan
        chunk_id:
          type: string
          title: Chunk Id
      type: object
      required:
        - row
        - col
        - rowspan
        - colspan
        - chunk_id
      title: ParseResponseTableCellGroundingPosition
  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

````