# Candidates

Operations related to anonymised candidates.

## Retrieve a page of anonymised candidates

 - [GET /v1/candidates](https://tc-api.redocly.app/openapi/candidates/findcandidates.md): Fetches a paginated array of anonymised candidates. Optionally filter candidates by their ISCO (International Standard Classification of Occupations) codes.

## Retrieve an anonymised candidate by candidate public ID

 - [GET /v1/candidates/{publicId}](https://tc-api.redocly.app/openapi/candidates/getcandidatebypublicid.md): Fetches details of an anonymised candidate by their unique public candidate ID.

## Retrieve a page of anonymised candidates in a saved list

 - [GET /v1/candidates/by-list/{publicListId}](https://tc-api.redocly.app/openapi/candidates/getcandidatesbypubliclistid.md): Fetches a paginated array of anonymised candidates belonging to a specific saved list, identified by its public ID.

## Expression of interest in candidates for a job

 - [POST /v1/candidates/job-match](https://tc-api.redocly.app/openapi/candidates/jobmatch.md): Allows prospective employers or recruiters to indicate that one or more candidates look like they match the requirements of a job, and that they are interested in proceeding further with those candidates.

## Offer to assist candidates

 - [POST /v1/candidates/offer-to-assist](https://tc-api.redocly.app/openapi/candidates/offertoassistcandidates.md): Allows candidate service providers to offer assistance to one or more candidates. For example, to invite eligible candidate's to access specialised services for education, migration or settlement support.

## Register a candidate with the Talent Catalog

 - [POST /v1/candidates/register](https://tc-api.redocly.app/openapi/candidates/registercandidate.md): Allows API users to register a candidate with the Talent Catalog by providing candidate information using the IdentifiableCandidate schema. Users should provide as much information as possible, including all required fields.