---
title: "Job status"
method: GET
path: "/jobs/{job_id}"
tags: ["Jobs"]
---

# Job status

`GET /jobs/{job_id}`

## Request

- Base URL: `https://api.scrupp.com/api/v1`
- URL: `https://api.scrupp.com/api/v1/jobs/{job_id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`

## Path parameters

- `job_id` integer, required

## Response `200`

Current status

- JobStatus
  - `job_id` integer
  - `status` 'queued' | 'running' | 'succeeded' | 'failed'
  - `progress` integer, nullable: Null when the job has no meaningful progress to report.
  - `records` integer
  - `cost` union
    - number
    - string
  - `retry_after` integer
  - `error` string, nullable
  - `metadata` object, nullable
  - `result_url` string

## Other responses

- `403`: Bad key, or a plan without API access
- `404`: No such task

---

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