---
title: "List notes that belong to a candidate"
method: GET
path: "/v0/candidates/{candidate_id}/notes"
tags: ["Candidate Notes"]
---

# List notes that belong to a candidate

`GET /v0/candidates/{candidate_id}/notes`

## Request

- Base URL: `https://api.gem.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gem.com/v0/candidates/{candidate_id}/notes`
- Auth: none declared

Returns a list of note objects on the given candidate and supports pagination and search
parameters `created_after`, `created_before`.

## Query parameters

- `created_after` integer
- `created_before` integer
- `sort` 'asc' | 'desc'
- `page` integer
- `page_size` integer

## Response `200`

OK

- Note[]
  - `id` string, ObjectID
  - `candidate_id` string, ObjectID, required
  - `user_id` string, ObjectID, required
  - `timestamp` integer
  - `is_private` boolean
  - `content` string, required

## Other responses

- `422`: Unprocessable Content
- `default`: Default error response

---

[API](https://skmtc.dev/gem/apis/gem-crm-api.md) - [All operations](https://skmtc.dev/gem/apis/gem-crm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gem/apis/gem-crm-api/revisions/50a984e3c2b5?raw)