---
title: "Get details of a particular candidate record"
method: GET
path: "/api/external/candidate/list"
tags: ["Candidate APIs"]
---

# Get details of a particular candidate record

`GET /api/external/candidate/list`

## Query parameters

- `items_per_page` string
- `current_page` string
- `include_files` integer
- `include_notes` integer
- `include_count` string

## Headers

- `RF-Api-Key` string, required

## Response `200`

Auto generated using Swagger Inspector

- object[]
  - `added_by` object
    - `id` integer
    - `img_link` string
    - `name` string
  - `added_time` string
  - `angellist_profile` string
  - `behance_profile` string
  - `client` object

## Changes

- **2026-08-13** `febc104d89ff` — 1 breaking
  - the `header` request parameter `RF-Api-Key` became required

[Change history](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/changes/api/external/candidate/list/get.md)

---

[API](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation.md) · [All operations](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recruiterflow/recruiterflow-api-documentation/revisions/febc104d89ff/schema)