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

# Get a job by ID

`GET /v2/jobs/{job_id}`

Returns the job with the specified `job_id`. Jobs are background processes, such as replacing the filterable metadata attributes.

## Path parameters

- `job_id` string, required

## Headers

- `Request-Timeout` integer
- `Request-Timeout-Millis` integer

## Response `200`

A job.

- Job — A background job for processing long-running operations on the platform.
  - `id` string, required — The ID of the job.
  - `type` 'rebuild_vector_index' | 'replace_filter_attributes' | 'bulk_delete_documents' | 'bulk_update_document_metadata' | 'unknown' — The type of job.
  - `corpus_keys` CorpusKey[] — The corpora that this job belongs to. Some jobs do not belong to any corpus.
  - `state` 'unknown' | 'queued' | 'started' | 'completed' | 'failed' | 'failed_will_retry' | 'aborted' — The state of a background job.
  - `created_at` string, date-time — When the job was created.
  - `started_at` string, date-time — When the job was started.
  - `completed_at` string, date-time — When the job was completed.
  - `created_by_username` string — The username of the user who created the job. This property can be absent, for example when the platform created the job.
  - `comment` string — A human-readable explanation of the job's current status. The format and content depend on the job type. On failure, this property contains the error message. This property can be absent.

## Other responses

- `403` — Permissions do not allow retrieving a job.
- `404` — Job not found.

---

[API](https://skmtc.net/vectara/apis/vectara-rest-api-v2.md) · [All operations](https://skmtc.net/vectara/apis/vectara-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vectara/vectara-rest-api-v2/revisions/fca567a46b3a/schema)