---
title: "Gets a job by its id."
method: GET
path: "/job/{jobId}"
tags: ["Job"]
---

# Gets a job by its id.

`GET /job/{jobId}`

## Path parameters

- `jobId` string, required

## Response `200`

OK

- GetJobByIdEndpointOutput — The result when a job has been retrieved.
  - `jobId` string, required — The job id.
  - `name` string, required — The job name.
  - `definitionId` string, required — The job definition id.
  - `audienceId` string, required — The audience id.
  - `revisionNumber` integer, required — The revision number.
  - `pipelineId` string, required — The pipeline id.
  - `state` 'Submitted' | 'Running' | 'Completed' | 'Failed' | 'ManualApproval' | 'Queued' | 'Paused' | 'StaleResults' | 'SpendLimited', required
  - `isPublic` boolean, required — Whether the job (and its results) is shared publicly.
  - `audienceDeleted` boolean, required — Whether the audience backing this job was deleted, meaning the job can never run.
  - `completedAt` string, date-time, nullable — The timestamp when the job was completed.
  - `resultFileName` string, nullable — The file name of the result.
  - `failedAt` string, date-time, nullable — The timestamp when the job failed.
  - `failureMessage` string, nullable — The failure message.
  - `reviewReason` 'ContentFlagged' | 'UnsupportedContentType' | 'CheckErrored' | 'ClassificationTimedOut' | 'null', nullable — Why the job was routed to manual review, when it is (or was) in ManualApproval. Null when no customer-facing reason applies.
  - `createdAt` string, date-time, required — The creation timestamp.
  - `ownerId` string, uuid, required — The owner id.
  - `ownerMail` string, required — The owner email.
  - `organizationId` string, required — The id of the organization that owns the entity.

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

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