---
title: "Get job by ID"
method: GET
path: "/jobs"
tags: ["Jobs"]
---

# Get job by ID

`GET /jobs`

Returns job details by job ID. If job is not found empty result is returned.

## Query parameters

- `ids` string, required
- `pretty` boolean

## Response `200`

Jobs details.

- JobsDetailsResponse
  - `data` JobDetails[], required
    - `id` string, required — Job ID
    - `status` 'running' | 'completed' | 'failed' | 'expired', required — Job status.
    - `creation_time` string, required — Job creation time. Returned for all statuses.
    - `completion_time` string — Job completion time. Returned for the "completed", "failed" and "expired" statuses.
    - `expiration_time` string — Results expiration time. Returned for the "completed" and "expired" statuses.
    - `error` ErrorObject
      - `type` string, required — Error type string. Can be used for error identification.
      - `message` string — Human-friendly error description. Can be amended without prior notification. Do not use for error identification in your code.
    - `results` JobResult[] — Array with results of the job execution. Returned only for the "completed" status.
      - `url` string, required — Job result URL

## Other responses

- `401` — Requested resource requires authorization.
- `403` — Requested resource is not available with supplied credentials.

---

[API](https://skmtc.net/coinmetrics/apis/coin-metrics-api-v4.md) · [All operations](https://skmtc.net/coinmetrics/apis/coin-metrics-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coinmetrics/coin-metrics-api-v4/revisions/774268c0a4fe/schema)