---
title: "List all candidates in your company"
method: GET
path: "/0/candidates"
tags: ["candidates"]
---

# List all candidates in your company

`GET /0/candidates`

## Request

- Base URL: `https://api.taleez.com`
- URL: `https://api.taleez.com/0/candidates`
- Auth: API key in header `X-taleez-api-secret`

💡 You can filter by any property (ex: source-candidat=linkedin).<br/><br/>🔑 You can access this if you have the 'candidates.list' scope activated on your secret key.

## Query parameters

- `page` integer
- `pageSize` integer
- `mail` string[]
- `withProps` boolean

## Response `200`

OK

## Other responses

- `400`: Something's wrong with your request, additional info will be provided in error message

---

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