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

# Get job by ID

`GET /jobs`

## Request

- Base URL: `https://api.coinmetrics.io/v4`
- URL: `https://api.coinmetrics.io/v4/jobs`
- Auth: API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/docs/jobs/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/coinmetrics/apis/coin-metrics-api-v4.md) - [All operations](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/revisions/774268c0a4fe?raw)