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

# GET /api/careers/v1/vacancies

`GET /api/careers/v1/vacancies`

Returns a list of open vacancies

## Query parameters

- `page` integer
- `per_page` integer
- `offset` integer
- `title` string
- `location_ids` integer[]
- `employment_type_ids` integer[]
- `sort_by` 'opened_at' | 'created_at' | 'updated_at'
- `sort_dir` 'asc' | 'desc'

## Response `200`

List of vacancies.

- object
  - `data` Vacancy[], required
    - `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.
  - `metadata` Metadata, required — Metadata model
    - `page` string, required
    - `per_page` string, required
    - `total_pages` string, required
    - `total_count` string, required

## Other responses

- `401` — The user is unauthorized.

---

[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/versions/ff612e61a4c3/schema)