---
title: "Check job status"
method: GET
path: "/job"
tags: ["job"]
---

# Check job status

`GET /job`

## Request

- Base URL: `https://public.stonly.com/api/v3`
- URL: `https://public.stonly.com/api/v3/job`
- Auth: HTTP basic

Checks the progress of an asynchronous background task. Returns the current status (e.g., completed, processing) and result details.

## Query parameters

- `jobId` string, uuid

## Response `200`

Job status retrieved successfully.

- object
  - `jobStatus` 'completed' | 'pending' | 'processing': Current state of the job.
  - `entities` JobElement[]: Details of the items processed by the job.
    - `id` string, required: ID of the entity being processed (e.g., guide ID).
    - `status` 'completed' | 'pending' | 'failed' | 'processing', required
    - `data` union
      - object
        - `duplicateGuideId` GuideId (unresolved $ref)
      - object
    - `error` string

## Other responses

- `default`: Standard error response.

---

[API](https://skmtc.dev/stonly/apis/stonly-public-api.md) - [All operations](https://skmtc.dev/stonly/apis/stonly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stonly/apis/stonly-public-api/revisions/4ba5b03a634a?raw)