---
title: "Return a list of existing positions (job openings)."
method: GET
path: "/recruiting/positions"
tags: ["Recruiting"]
---

# Return a list of existing positions (job openings).

`GET /recruiting/positions`

This endpoint will return a paginated list of positions. The URL params will help to filter the results.

## Query parameters

- `_id` string
- `status` 'Active' | 'Draft' | 'Closed' | 'Archived'
- `companyId` string
- `officeId` string
- `departmentId` string
- `positionType` 'Full-time' | 'Part-time' | 'Flexible' | 'Temporary' | 'Freelance' | 'Intern' | 'Student' | 'Apprentice'
- `limit` 25 | 50 | 100
- `offset` number

## Response `200`

OK. Paginated list of positions.

- object
  - `data` object[]
    - `_id` string — The unique identifier of the job posting.
    - `jobTitle` string — The title of the job position.
    - `companyId` string — The unique identifier of the company.
    - `officeId` string — The unique identifier of the office.
    - `departmentId` string — The unique identifier of the department.
    - `positionType` string — The type of the position (e.g., full-time, part-time).
    - `status` string — The current status of the job posting.
    - `jobDescription` object
      - `html` string — HTML formatted job description.
  - `metadata` object
    - `limit` number — The maximum number of items per page.
    - `offset` number — The starting point of the data retrieval.
    - `total` number — The total number of items available.
    - `count` number — The number of items retrieved in the current response.

## Other responses

- `400` — BAD REQUEST. This is a wrong request in the client side due to invalid body or params.
- `401` — UNAUTHORIZED. The Authorization header is incorrect, not provided or the token expired.

---

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