---
title: "Get job completion percentage"
method: POST
path: "/v1/data/job/status"
tags: ["v1 data"]
---

# Get job completion percentage

`POST /v1/data/job/status`

Retrieve the current processing status of an ingestion job.

    Use the job_id returned from /ingest to check if processing is complete.

    **Request Parameters:**
    - job_id (str, required): Unique identifier from /ingest response

    **Response:**
    - job_id (str): The requested job identifier
    - status (str): Current status - "queued", "processing", "completed", "failed", or "cancelled"

    **Example:**
    ```json
    {
        "job_id": "123e4567-e89b-12d3-a456-426614174000"
    }
    ```

    Returns 200 OK with current status. Poll periodically until status is "completed" or "failed".
    Requires JWT authentication.

## Request body

- JobCompletionRequest — Request model for job completion percentage
  - `job_id` string, required — Unique identifier for the job

## Response `200`

Successful Response

- JobCompletionResponse — Response model for job completion percentage
  - `job_id` string, required — The job ID
  - `status` string, required — Current job status: done, partial, processing, not started, error, cancelled
  - `completion` integer — Completion percentage (0-100)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Job Not Found
- `422` — Validation Error
- `500` — Internal Server Error

## Changes

- **2026-03-10** `f5610a9dc1d7` — 1 info
  - added the optional property `completion` to the response with the `200` status
- **2025-12-10** `5a9a6b9cb07a` — 12 info
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `401` status
  - added the optional property `details` to the response with the `404` status
  - added the optional property `details` to the response with the `500` status
  - …8 more

[Change history](https://skmtc.dev/elicitlabs/apis/elicit-labs-api/changes/v1/data/job/status/post.md)

---

[API](https://skmtc.dev/elicitlabs/apis/elicit-labs-api.md) · [All operations](https://skmtc.dev/elicitlabs/apis/elicit-labs-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/elicitlabs/elicit-labs-api/revisions/27701839a070/schema)