GET /candidates/{id}/profile — Full Candidate Profile

The profile endpoint returns a candidate’s complete Cutshort profile, including detailed work history, education, projects, skill validations, and salary expectations. Full contact details are included only after the candidate has accepted an invite or your account has profile-view credits.

Endpoint

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

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/profile' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

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

Response

Returns 200 OK with the candidate’s complete profile.

{
  "id": "cand_8f3kL9mN",
  "name": "Priya Menon",
  "headline": "Senior Python Engineer",
  "location": "Bengaluru",
  "experience_years": 5,
  "quality_score": 82,
  "availability": "active",
  "skills": [
    { "name": "Python", "verified": true, "years": 5 },
    { "name": "FastAPI", "verified": false, "years": 2 },
    { "name": "PostgreSQL", "verified": true, "years": 4 }
  ],
  "experience": [
    {
      "company": "Swiggy",
      "role": "Backend Engineer",
      "from": "2021-06",
      "to": "present",
      "description": "Built real-time order tracking APIs serving 5M daily users"
    }
  ],
  "education": [
    {
      "institution": "IIT Bombay",
      "degree": "B.Tech Computer Science",
      "year": 2019
    }
  ],
  "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 title.

string

The candidate’s current city or preferred work location.

integer

Total years of professional experience.

integer

AI-generated quality score from 0 to 100.

string

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

array

List of skill objects, each containing a skill name, a verified boolean indicating Cutshort validation, and years of experience.

array

Chronological list of work history entries. Each entry includes company, role, from date, to date (or "present"), and a description.

array

List of education records. Each entry includes institution, degree, and graduation year.

integer

Minimum expected annual salary in INR.

integer

Maximum expected annual salary in INR.

string

Direct URL to the candidate’s Cutshort profile page.

The email and phone fields are only populated after the candidate accepts an outreach invite or you use a profile-view credit from your plan.

Overview

Candidates

Jobs

Sourcing

Webhooks

GET /candidates/{id}/profile — Full Candidate Profile

Endpoint

Path Parameters

Example Request

Response

Response Fields

​Endpoint

​Path Parameters

​Example Request

​Response

​Response Fields

Endpoint

Path Parameters

Example Request

Response

Response Fields