---
title: "Returns the details of a given Job."
method: GET
path: "/v2/jobs/{job_id}"
tags: ["Jobs"]
---

# Returns the details of a given Job.

`GET /v2/jobs/{job_id}`

## Request

- Base URL: `http://localhost:8082`
- URL: `http://localhost:8082/v2/jobs/{job_id}`
- Auth: none declared. Required headers: `authorization`
- TypeScript: <https://skmtc.dev/centrifuge/apis/centrifuge-os-node-api/docs/v2/jobs/:job_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the details of a given Job.

## Path parameters

- `job_id` string, required

## Headers

- `authorization` string, required

## Response `200`

OK

- V2Job
  - `JobID` string: Job Identifier
  - `desc` string: description of the Job
  - `finished` boolean: job status
  - `finished_at` string: Job finished at. If empty, job is not complete yet
  - `overrides` object: overrides for the Job
  - `runner` string: name of the Runner
  - `tasks` GoceleryTask[]: list of tasks ran under this Job
    - `args` object[]: arguments passed to this task
    - `delay` string: delay until ready to be run
    - `error` string: error after task run
    - `result` object: result after the task run
    - `runnerFuncs` string: name of the runnerFuncs
    - `tries` integer: number of times task was run.
  - `valid_until` string: validity of the job

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/centrifuge/apis/centrifuge-os-node-api.md) - [All operations](https://skmtc.dev/centrifuge/apis/centrifuge-os-node-api/llms.txt) - [OpenAPI document](https://skmtc.dev/centrifuge/apis/centrifuge-os-node-api/revisions/36808f8744e0?raw)