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

# Get job results

`GET /v1/jobs/{job_id}/results`

## Request

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

<b>Beta:</b> Return a download link for the results file of a completed job. The results file only exists once every check in the job has been processed, so this returns 409 for any job that is not `completed`.

## Path parameters

- `job_id` string, required

## Response `200`

Successful Response

- JobResultsResponse
  - `job_id` string, required
  - `results_url` string, required: Pre-signed download link for the results file. The link expires 10 minutes after this response is issued; call this endpoint again to get a fresh one.
  - `status` 'running' | 'completed' | 'failed' | 'cancelled', required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: The job has no results file yet because it is still running, or because it failed or was cancelled. The body carries the job's current `status`; poll GET /v1/jobs/{job_id} until it reports `completed`.
- `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/results/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)