List Talent Pool Candidates

GET

/api/v1/client/talent-pools/{talent_pool_id}/candidates/

Last modified:2025-12-30 13:07:46

Retrieves a list of candidates associated with a specific talent pool for the authenticated company, with support for filtering, searching, sorting, and pagination.

Arguments

talent_pool_id (int, as path parameter) : The unique identifier of the talent pool to retrieve candidates from.

Example: talent_pool_id=123

page (string, as query parameter, optional) : Page number for paginated results.

Example: page=1

page_size (string, as query parameter, optional) : Number of results per page.

Example: page_size=10

Returns

200 OK : A paginated list of candidates associated with the specified talent pool, including candidate details such as name, email, and other relevant fields.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.recruspace.com/api/v1/client/talent-pools//candidates/?page&page_size' \
--header 'Authorization: Bearer <token>'

Response Example

[
    {
        "id": 0,
        "entry_method": "applied",
        "source_platform": "api",
        "job_post": {
            "hash": "string",
            "title": "string",
            "status": "draft",
            "pipeline": 0
        },
        "initial_applied_job_post": {
            "hash": "string",
            "title": "string",
            "status": "draft",
            "pipeline": 0
        },
        "email": "user@example.com",
        "first_name": "string",
        "last_name": "string",
        "cv": {
            "id": 0,
            "path": "string",
            "name": "string",
            "type": "string",
            "file_size": -2147483648,
            "base": "string",
            "presigned_url": "string",
            "uploaded_at": "2019-08-24T14:15:22.123Z"
        },
        "photo": {
            "id": 0,
            "path": "string",
            "name": "string",
            "type": "string",
            "file_size": -2147483648,
            "base": "string",
            "presigned_url": "string",
            "uploaded_at": "2019-08-24T14:15:22.123Z"
        },
        "phone_number": "string",
        "address": "string",
        "city": "string",
        "country": "string",
        "score": 0,
        "is_seen": true,
        "created_at": "2019-08-24T14:15:22.123Z",
        "tags": [
            {
                "id": 0,
                "title": "string"
            }
        ],
        "suitability": "suitable",
        "substage": {
            "id": 0,
            "stage": {
                "id": 0,
                "name": "string",
                "key": "string",
                "created_at": "2019-08-24T14:15:22.123Z",
                "pipeline": 0
            },
            "name": "string",
            "queue": -2147483648,
            "is_visible": true,
            "created_at": "2019-08-24T14:15:22.123Z",
            "email_template": 0
        },
        "error_status": true,
        "error_logs": [
            "string"
        ]
    }
]

Modified at 2025-12-30 13:07:46

Delete Talent Pool

Create Talent Pool