Skip to main content
GET
/
v1
/
candidates
/
{id}
Get candidate by ID
curl --request GET \
  --url https://api.stardex.ai/v1/candidates/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "id": "234e5678-e90a-12b3-c456-789012345678",
    "person_id": "345e6789-e01b-23c4-d567-890123456789",
    "job_id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Jane Smith",
    "current_job_title": "Software Engineer",
    "current_company_name": "Tech Corp",
    "current_company_id": "456e7890-e12b-34d5-a678-901234567890",
    "current_pipeline_stage_name": "Technical Interview",
    "current_pipeline_stage_id": "567e8901-e23c-45d6-e789-012345678901",
    "current_pipeline_stage_date": "2024-01-15T10:00:00Z",
    "created_at": "2024-01-12T14:30:00Z",
    "pipeline_stage_history": [
      {
        "stage_id": "345e6789-e01b-23c4-d567-890123456789",
        "stage_name": "Application Review",
        "stage_date": "2024-01-12T14:30:00Z"
      },
      {
        "stage_id": "567e8901-e23c-45d6-e789-012345678901",
        "stage_name": "Technical Interview",
        "stage_date": "2024-01-15T10:00:00Z"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.stardex.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Authenticate with a Bearer token: API key, OAuth token, or session token.

Path Parameters

​
id
string
required

Candidate ID

Response

Candidate fetched

​
success
enum<boolean>
required
Available options:
true
​
data
object
required