---
title: "Get analyse job status"
method: GET
path: "/api/analyse/job/{uid}"
tags: ["Analyse"]
---

# Get analyse job status

`GET /api/analyse/job/{uid}`

## Request

- Base URL: `https://snapwonders.com`
- URL: `https://snapwonders.com/api/analyse/job/{uid}`
- Auth: API key in header `X-Api-Key`

Returns the current status and per-item progress of an analysis job. Poll this endpoint until `status` is `done`, `partial`, or `failed`. Once done, use `job_uid` to call `GET /api/analyse/result/{job_uid}` with the same `X-Api-Key` to retrieve results. **Authentication:** `X-Api-Key` header required.

## Path parameters

- `uid` string, uuid, required

## Response `200`

Job status

- object
  - `upload_uid` string, uuid
  - `job_uid` string, uuid: Pass to `GET /api/analyse/result/{job_uid}` with the same `X-Api-Key` to retrieve full results once done.
  - `status` 'queued' | 'processing' | 'completed' | 'partial' | 'failed' | 'terminated'
  - `total_items` integer: Total number of files in this job
  - `completed` integer: Number of items successfully analysed
  - `failed` integer: Number of items that failed
  - `queued_at` string, date-time, nullable
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `items` object[]
    - `uid` string, uuid
    - `name` string
    - `status` 'queued' | 'processing' | 'completed' | 'failed'
    - `error` string, nullable

## Other responses

- `401`: Not authenticated. `error` names the exact cause: `missing_api_key`, `malformed_api_key`, `invalid_api_key` (key unknown/revoked/expired), or — when the key itself is valid — `account_not_verified` / `account_inactive`.
- `404`: Job not found
- `410`: Session expired — sessions are valid for 24 hours from creation

---

[API](https://skmtc.dev/snapwonders/apis/snapwonders-api-mcp.md) · [All operations](https://skmtc.dev/snapwonders/apis/snapwonders-api-mcp/llms.txt) · [OpenAPI document](https://skmtc.dev/snapwonders/apis/snapwonders-api-mcp/revisions/645bbccc9550?raw)