GET /candidates/{id} — Look Up a Candidate by ID

Retrieve a specific candidate’s summary record using their Cutshort ID. Use this endpoint to fetch fresh data after a search, or to verify candidate details before sending an invite.

Endpoint

GET https://api.cutshort.io/v1/candidates/{id}

Path Parameters

string

required

The candidate’s unique Cutshort ID (e.g., cand_8f3kL9mN).

Example Request

curl -X GET 'https://api.cutshort.io/v1/candidates/cand_8f3kL9mN' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

response = requests.get(
    "https://api.cutshort.io/v1/candidates/cand_8f3kL9mN",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

Response

Returns 200 OK with the candidate’s summary record.

{
  "id": "cand_8f3kL9mN",
  "name": "Priya Menon",
  "headline": "Senior Python Engineer",
  "location": "Bengaluru",
  "experience_years": 5,
  "skills": ["Python", "FastAPI", "PostgreSQL", "Docker"],
  "quality_score": 82,
  "availability": "active",
  "salary_expectation_min": 2000000,
  "salary_expectation_max": 2800000,
  "profile_url": "https://cutshort.io/candidate/priya-menon"
}

Response Fields

string

Unique Cutshort candidate ID.

string

The candidate’s full name.

string

The candidate’s professional headline or current role.

string

The candidate’s current city or preferred work location.

integer

Total years of professional experience.

array

List of skill names associated with the candidate’s profile.

integer

AI-generated quality score from 0 to 100.

string

The candidate’s current job-search status. One of active, open, or not_looking.

integer

Minimum expected annual salary in INR.

integer

Maximum expected annual salary in INR.

string

Direct URL to the candidate’s full Cutshort profile.

Error Response

If no candidate exists for the given ID, the API returns 404 Not Found.

{
  "error": {
    "code": "not_found",
    "message": "Candidate not found."
  }
}

Overview

Candidates

Jobs

Sourcing

Webhooks

GET /candidates/{id} — Look Up a Candidate by ID

Endpoint

Path Parameters

Example Request

Response

Response Fields

Error Response

​Endpoint

​Path Parameters

​Example Request

​Response

​Response Fields

​Error Response

Endpoint

Path Parameters

Example Request

Response

Response Fields

Error Response