> For the complete documentation index, see [llms.txt](https://developers.welcomekit.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.welcomekit.co/candidates-api.md).

# Candidates API

- [Candidates](https://developers.welcomekit.co/candidates-api/candidates.md)
- [List candidates](https://developers.welcomekit.co/candidates-api/candidates/untitled.md): This endpoint lets you retrieve all candidates for a given job reference.
- [Retrieve a candidate](https://developers.welcomekit.co/candidates-api/candidates/retrieve-a-candidate.md): This endpoint allows you to retrieve candidate info by his reference.
- [Create a candidate](https://developers.welcomekit.co/candidates-api/candidates/create-a-candidate.md): This endpoint allows you create new candidates for a given job\_reference.
- [Update a candidate](https://developers.welcomekit.co/candidates-api/candidates/update-a-candidate.md): This endpoint allows you update candidates for a given reference.
- [Comment](https://developers.welcomekit.co/candidates-api/create-a-comment.md): This endpoint lets you create new comments for a given candidate\_reference.
- [Emails](https://developers.welcomekit.co/candidates-api/emails.md)
- [List candidate emails](https://developers.welcomekit.co/candidates-api/emails/list-candidate-emails.md): This endpoint allows you retrieve all emails for a given candidate reference.
- [Create an email](https://developers.welcomekit.co/candidates-api/emails/create-an-email.md): This endpoint lets you create a new email for a given candidate\_reference.
- [Documents](https://developers.welcomekit.co/candidates-api/documents.md)
- [List candidate documents](https://developers.welcomekit.co/candidates-api/documents/list-candidate-documents.md): This endpoint lets you retrieve all attached documents for a given candidate\_reference.
- [Attach documents to a candidate](https://developers.welcomekit.co/candidates-api/documents/attach-documents-to-a-candidate.md): This endpoint lets you attach new documents for a given candidate\_reference.
- [Current user](https://developers.welcomekit.co/candidates-api/get-current-user.md)