---
title: "GET /api/careers/v1/vacancies/{id}"
method: GET
path: "/api/careers/v1/vacancies/{id}"
tags: ["vacancies"]
---

# GET /api/careers/v1/vacancies/{id}

`GET /api/careers/v1/vacancies/{id}`

Returns a single vacancy.

## Path parameters

- `id` integer, required

## Response `200`

Vacancy details.

- Vacancy — Vacancy model
  - `id` string, required
  - `title` string, required — The title of the vacancy,
  - `description` string, required — Description used to promote the vacancy opening to the careers page. Note that the description may include HTML code to support text formatting. Ensure it is parsed accordingly.
  - `department` string, required — Department of the vacancy.
  - `location` string, required — Location of the vacancy.
  - `employment_type` string, required — Employment type of the vacancy.
  - `apply_url` string, required — This URL links to the application form that allows new candidates to apply for the vacancy. It is essential to use this link as your application form, to ensure that candidate details are automatically submitted to PeopleForce.

## Other responses

- `401` — Unauthorized
- `404` — Vacancy is not found.

---

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