> ## 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: Vision Tools API version: 0.1.0 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 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 ````