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

# Gets a job definition by its id.

`GET /job/definition/{definitionId}`

## Path parameters

- `definitionId` string, required

## Response `200`

OK

- GetJobDefinitionByIdEndpointOutput — The result when a job definition has been retrieved.
  - `definitionId` string, required — The job definition id.
  - `name` string, required — The name of the job definition.
  - `definitionType` 'Unknown' | 'Classify' | 'Compare' | 'BoundingBox' | 'Line' | 'Polygon' | 'Locate' | 'Transcription' | 'NamedEntity' | 'FreeText' | 'Scrub' | 'Ranking' | 'GroupedRanking' | 'Evaluation', required
  - `isPublic` boolean, required — Whether the definition is shared publicly as a reusable template.
  - `createdAt` string, date-time, required — The creation timestamp.
  - `ownerId` string, uuid, required — The id of the job definition's owner.
  - `ownerMail` string, required — The email of the job definition's owner.
  - `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)