---
title: "Get Job"
method: GET
path: "/jobs/{job-id}"
tags: ["Jobs"]
---

# Get Job

`GET /jobs/{job-id}`

## Request

- Base URL: `https://examplefirm.addepar.com/api/v1`
- URL: `https://examplefirm.addepar.com/api/v1/jobs/{job-id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/addepar/apis/addepar-api/docs/jobs/:job-id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the status and parameters for a specific job.

## Path parameters

- `job-id` string, required

## Headers

- `Addepar-Firm` string, required

## Response `200`

successful operation

- JobStatusJsonApiFormat
  - `data` JobStatusJson
    - `completed_at` string, date-time
    - `creator` string
    - `errors` JsonApiError[]
      - `code` string
      - `detail` string
      - `id` string
      - `source` JsonApiErrorSource
        - `parameter` string
        - `pointer` JsonPointer
          - `matchingIndex` integer
          - `matchingProperty` string
      - `status` string
      - `title` string
    - `id` string
    - `job_type` string
    - `parameters` object
    - `percent_complete` number, double
    - `started_at` string, date-time
    - `status` string
  - `meta` object

## Other responses

- `303`: successful operation; job is complete, so See Other provided to view the results of the job at the resulting URI
- `401`: Unauthorized
- `404`: job with given ID does not exist

---

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