---
title: "Get job status"
method: GET
path: "/v1/jobs/{job_id}"
tags: ["jobs"]
---

# Get job status

`GET /v1/jobs/{job_id}`

## Request

- Base URL: `https://coverage-api.meetnirvana.com`
- URL: `https://coverage-api.meetnirvana.com/v1/jobs/{job_id}`
- Auth: none declared

<b>Beta:</b> Return the current status of a job and how many of its checks have completed, failed, or are still in process.

## Path parameters

- `job_id` string, required

## Response `200`

Successful Response

- JobMetadataResponse
  - `completed` integer, required
  - `failed` integer, required
  - `in_process` integer, required
  - `job_id` string, required
  - `results_url` string, required: Results endpoint for this job. Returns a download link once the job has completed.
  - `status` 'running' | 'completed' | 'failed' | 'cancelled', required
  - `status_url` string, required: Poll this URL for the current job status and progress counts.
  - `total` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `504`: Gateway Timeout

## Changes

- **2026-11-03** `f90ee559b8c7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/meetnirvana/apis/nirvana-api/changes/v1/jobs/:job_id/get.md)

---

[API](https://skmtc.dev/meetnirvana/apis/nirvana-api.md) - [All operations](https://skmtc.dev/meetnirvana/apis/nirvana-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meetnirvana/apis/nirvana-api/revisions/f90ee559b8c7?raw)