---
title: "List candidate files"
method: GET
path: "/candidates/{id}/files"
tags: ["Candidates"]
---

# List candidate files

`GET /candidates/{id}/files`

## Request

- Base URL: `https://api.100hires.com/v2`
- URL: `https://api.100hires.com/v2/candidates/{id}/files`
- Auth: HTTP bearer

Lists candidate attachments and metadata (resume/other files). Use for document sync, compliance exports, and recruiter tooling.

## Path parameters

- `id` string, required

## Query parameters

- `view` 'full' | 'summary'

## Response `200`

Candidate files

- CandidateFilesResponse
  - `files` CandidateFile[], required: Array of candidate files.
    - `uuid` string, uuid, required: Unique attachment identifier. Stable across API calls; use in referencing endpoints.
    - `url` string, uri, nullable, required: Absolute download URL (e.g. `https://api.100hires.com/v2/attachments/application/{uuid}/{file_name}`). Hit with `Authorization: Bearer <API_KEY>`.
    - `relative_time` string, required: Human-readable time since upload (e.g. `"2 days ago"`).
    - `file` AttachmentFile, required
      - `is_image` boolean, nullable, required: Whether the file is an image.
      - `orig_file_name` string, required: Original file name.
      - `file_ext` string, required: File extension.
      - `file_type` string, required: File type category.
      - `readable_size` string, required: Human-readable file size.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Too many requests

---

[API](https://skmtc.dev/100hires/apis/100hires-api.md) · [All operations](https://skmtc.dev/100hires/apis/100hires-api/llms.txt) · [OpenAPI document](https://skmtc.dev/100hires/apis/100hires-api/revisions/e63e2d3115f7?raw)