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

# Get a job

`GET /jobs/{job_id}`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/jobs/{job_id}`
- Auth: HTTP bearer

Progress of a long call and, once it finished, its result or error.

## Path parameters

- `job_id` string, required

## Response `200`

The result.

- object
  - `id` string, required
  - `kind` string, required
  - `status` 'queued' | 'running' | 'succeeded' | 'failed', required
  - `progress` integer, required
  - `poll_after_ms` integer, nullable, required
  - `result` union, required
    - string
    - number
    - boolean
    - EnvelopeEventsOutSchema0[]
      - union
        - string
        - number
        - boolean
        - EnvelopeEventsOutSchema0[]
        - object
    - object
  - `error` object, nullable, required
    - `code` string, required
    - `message` string, required
    - `hint` string
  - `created_at` string, date-time, required
  - `finished_at` string, date-time, nullable, required

## Other responses

- `default`: An RFC 9457 problem.

---

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