List Talent Pool Candidates

GET

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

Last modified:2026-07-28 11:05:53

Retrieves a paginated list of candidates associated with a specific talent pool for the authenticated company.

This endpoint supports pagination only. Filtering, searching and sorting are not available here.

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 (integer, as query parameter, optional) : Page number for paginated results. Defaults to 1.

Example: page=1

page_size (integer, as query parameter, optional) : Number of results per page. Defaults to 12, maximum 100.

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.

404 Not Found : The talent pool does not exist or does not belong to the authenticated company.

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

Bodyapplication/json

🟠400

🟠403

🟠404

🟠423

🟠429

🔴500

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "success": "OK",
    "content": {
        "count": 42,
        "next": "http://example.com",
        "previous": "http://example.com",
        "results": [
            {
                "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
                },
                "is_errored": true,
                "error_logs": [
                    "string"
                ]
            }
        ]
    }
}

Modified at 2026-07-28 11:05:53

Delete Talent Pool

Create Talent Pool