---
title: "Return a list of applications. It will include custom fields, if any."
method: GET
path: "/recruiting/applications"
tags: ["Recruiting"]
---

# Return a list of applications. It will include custom fields, if any.

`GET /recruiting/applications`

## Query parameters

- `_positionId` string
- `_candidateId` string
- `stageId` string
- `isDisqualified` boolean
- `source` string
- `rejectionReason` string
- `limit` 25 | 50 | 100
- `offset` number

## Headers

- `Authorization` string, required

## Response `200`

OK. Paginated list of candidates.

- object
  - `data` object[]
    - `_id` string — The unique identifier of the application.
    - `_positionId` string — The id of the position.
    - `_candidateId` string — The id of the candidate who applied to the position.
    - `stageId` string — The id of the stage of this application.
    - `source` string — The source of the entry (e.g., API, manual, agency, browserExtension).
    - `isDisqualified` boolean — If this application has been disqualified or not.
    - `rejectionReason` string — The reason why the candidate got rejected.
    - `hiredDate` string, date-time — Timestamp when the application was moved to the hired status. Omitted if the application was never hired.
    - `rejectionDate` string, date-time — Timestamp when the application was rejected. Omitted if the application was never rejected.
    - `candidateOrigin` string — The origin of the candidate's application.
    - `_createdById` string — The unique identifier of the creator of the record.
    - `_updatedById` string — The unique identifier of the updater of the record.
    - `_createdAt` string, date-time — The creation date of the record in ISO 8601 format.
    - `_updatedAt` string, date-time — The last update date of the record in ISO 8601 format.
  - `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)