---
title: "Get Job"
method: GET
path: "/api/v1/jobs/{job_id}"
tags: ["public-api"]
---

# Get Job

`GET /api/v1/jobs/{job_id}`

## Request

- Base URL: `https://ndi-api.nace.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://ndi-api.nace.ai/api/v1/jobs/{job_id}`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/nace/apis/ndi-service/docs/api/v1/jobs/:job_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Return the current state of a job (tenant-scoped; other tenants see 404).

## Path parameters

- `job_id` string, uuid, required

## Response `200`

Successful Response

- NdiServiceAppSchemasPublicJobStatus: Response for ``GET /jobs/{job_id}`` and the sync endpoints.
  - `job_id` string, uuid, required
  - `action` string, required: One of ``parse``/``ground``/``categorize``/``extract``.
  - `status` string, required: One of ``pending``/``running``/``succeeded``/``failed``.
  - `result` union: Action-specific result (tagged by ``result_type``); populated only when ``status=succeeded``.
    - NdiServiceAppSchemasPublicParseResult
      - `result_type` 'parse'
      - `status` 'success' | 'failed'
      - `error` string, nullable
      - `item` union
        - ParsedFile
          - `item_type` 'file'
          - `markdown_url` string, required
          - `page_count` integer
          - `char_count` integer
          - `extraction_duration_ms` integer
          - `audio_duration_seconds` number: Duration of the source audio in seconds; non-zero only for audio parses.
        - ParsedTable
          - `item_type` 'table'
          - `sheets` ParsedSheet[]
            - `sheet_name` string, required
            - `markdown_url` string, required
            - `max_row` integer
            - `max_col` integer
            - `char_count` integer
            - `non_empty_cell_count` integer
    - NdiServiceAppSchemasPublicGroundResult
      - `result_type` 'ground'
      - `results` GroundItemResult[]
        - `item_id` string, required
        - `found` boolean
        - `matches` union[]
          - union
            - VisualRegionMatch
              - …
            - AudioRangeMatch
              - …
            - SpreadsheetRangeMatch
              - …
            - TextRangeMatch
              - …
            - JsonlRecordMatch
              - …
            - RowRangeMatch
              - …
            - JsonPointerMatch
              - …
        - `error` string, nullable
      - `total_items_found` integer
      - `total_items_requested` integer
      - `duration_ms` integer
      - `transcript_url` string, nullable: Storage URL of the MediaTimeline JSON used for grounding.
    - NdiServiceAppSchemasPublicCategorizeResult
      - `result_type` 'categorize'
      - `status` 'success' | 'failed'
      - `error` string, nullable
      - `items` union[]
        - union
          - CategorizedSegment
            - `kind` 'document_segment'
            - `file_name` string, required
            - `page_start` integer, required
            - `page_end` integer, required
            - `category` string, required
            - `subcategory` string, required
            - `is_freeform_subcategory` boolean
            - `summary` string, required
            - `keywords` string[]
            - `markdown_url` string, nullable
          - CategorizedSheet
            - `kind` 'sheet'
            - `file_name` string, required
            - `sheet_name` string, required
            - `categories` CategorizedCategory[], required
              - …
            - `has_freeform_subcategories` boolean
            - `summary` string, required
            - `keywords` string[]
            - `markdown_url` string, nullable
    - NdiServiceAppSchemasPublicExtractResult
      - `result_type` 'extract'
      - `status` 'success' | 'failed'
      - `error` string, nullable
      - `data` object, nullable: Extracted values matching the request schema. Fields the document does not contain are null (scalars) or empty arrays.
      - `json_url` string, nullable: URL of the extraction JSON artifact (same content as ``data``).
      - `page_count` integer
      - `sheet_count` integer
  - `error` JobError
    - `code` string, required: Stable machine-readable error code.
    - `message` string, required: Human-readable failure detail.
  - `is_example` boolean: True for provisioned Playground example jobs.
  - `created_at` string, date-time, required
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `credits_used` integer, nullable: Credits charged to this job per the ledger. 0 for failed/cancelled jobs (never charged) and zero-credit example jobs; null while the job is non-terminal (not counted yet) or for a succeeded job predating the ledger.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `413`: Request Entity Too Large
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/nace/apis/ndi-service.md) - [All operations](https://skmtc.dev/nace/apis/ndi-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nace/apis/ndi-service/revisions/d9d1f8ec2207?raw)