---
title: "List candidates in a project"
method: GET
path: "/v0/projects/{project_id}/candidates"
tags: ["Project and Candidates Membership"]
---

# List candidates in a project

`GET /v0/projects/{project_id}/candidates`

## 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/projects/{project_id}/candidates`
- Auth: none declared

Returns a list of all candidates in the project given the project_id. Supports
search parameters `added_after`, `added_before`.

## Query parameters

- `added_after` integer
- `added_before` integer
- `sort` 'asc' | 'desc'
- `page` integer
- `page_size` integer

## Response `200`

OK

- ProjectCandidateMembership[]
  - `candidate_id` string, ObjectID
  - `added_at` integer

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