---
title: "Get documents for a candidate."
method: GET
path: "/recruiting/candidates/{candidateId}/documents"
tags: ["Recruiting"]
---

# Get documents for a candidate.

`GET /recruiting/candidates/{candidateId}/documents`

Returns a paginated list of documents (CVs, cover letters, attachments) belonging to the candidate. Each document includes a signed download URL valid for 24 hours.

## Path parameters

- `candidateId` string, required

## Query parameters

- `limit` 25 | 50 | 100
- `offset` number

## Response `200`

OK. Paginated list of candidate documents.

- object
  - `data` object[]
    - `_id` string — The unique identifier of the document.
    - `name` string — The original file name.
    - `url` string, nullable — Signed S3 URL to download the file. Valid for 24 hours. Null if no file is attached.
    - `_createdAt` string, date-time — Upload date in ISO 8601 format.
  - `metadata` object
    - `limit` number
    - `offset` number
    - `total` number
    - `count` number

## 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.
- `404` — NOT FOUND. No candidate exists with the given ID.

---

[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)