---
title: "GET /v1/jobs/{jobId}"
method: GET
path: "/v1/jobs/{jobId}"
tags: ["Jobs"]
---

# GET /v1/jobs/{jobId}

`GET /v1/jobs/{jobId}`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/jobs/{jobId}`
- Auth: API key in header `x-api-key`

## Path parameters

- `jobId` string, required

## Response `200`

- JobStatusResponseDto
  - `jobId` string, required: Job ID
  - `status` 'pending' | 'completed' | 'failed', required: Job status
  - `finishedOn` number: BullMQ completion timestamp in milliseconds
  - `returnValue` unknown
  - `progress` object, required: Job progress counters
    - `completed` number, required: Completed units
    - `total` number, required: Total units
    - `transactionsSynced` number, required: Synced transaction count

---

[API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)