Get Candidate

GET

/api/v1/client/candidates/{candidate_id}/

Last modified:2025-12-30 13:08:58

Retrieves detailed information about a specific candidate associated with the authenticated company.

Arguments

candidate_id (int, as path parameter) : The unique identifier of the candidate to retrieve.

Example: candidate_id=123

Returns

200 OK : A detailed representation of the specified candidate, including information such as name, email, and any related presigned file URLs.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.recruspace.com/api/v1/client/candidates//' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "id": 0,
    "company": "string",
    "user": {
        "id": 0,
        "email": "user@example.com",
        "first_name": "string",
        "last_name": "string",
        "profile_img": {
            "id": 0,
            "path": "string",
            "name": "string",
            "type": "string",
            "file_size": -2147483648,
            "base": "string",
            "presigned_url": "string",
            "uploaded_at": "2019-08-24T14:15:22.123Z"
        }
    },
    "job_post": {
        "hash": "string",
        "title": "string",
        "status": "draft",
        "pipeline": 0
    },
    "initial_applied_job_post": {
        "hash": "string",
        "title": "string",
        "status": "draft",
        "pipeline": 0
    },
    "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
    },
    "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",
    "education": [
        {
            "school_name": "string",
            "degree": "bachelor",
            "major": "string",
            "start_date": "2019-08-24",
            "end_date": "2019-08-24",
            "currently_pursuing": true
        }
    ],
    "work_experience": [
        {
            "company_name": "string",
            "position_title": "string",
            "employment_type": "full_time",
            "start_date": "2019-08-24",
            "end_date": "2019-08-24",
            "currently_employed": true
        }
    ],
    "links": [
        {
            "platform": "linkedin",
            "url": "string"
        }
    ],
    "tags": [
        {
            "id": 0,
            "title": "string"
        }
    ],
    "suitability": "suitable",
    "is_pinned": true,
    "is_parsed": true,
    "score": 0,
    "skills": [
        "string"
    ],
    "total_work_experience": 0,
    "seniority": "string",
    "is_seen": true,
    "rejected_mail_sended": true,
    "source_platform": "api",
    "entry_method": "applied",
    "error_status": true,
    "created_at": "2019-08-24T14:15:22.123Z",
    "updated_at": "2019-08-24T14:15:22.123Z"
}

Modified at 2025-12-30 13:08:58

Pagination

Create Candidate