Skip to main content
In Cutshort, a candidate is a verified tech professional whose profile is enriched with validated skills, work history, education, salary expectations, and quality signals. The Cutshort API exposes this data so you can search, filter, and retrieve candidate profiles programmatically.

​
Candidate data model

Every candidate object returned by the API contains the following fields:
​
string
required
Unique identifier for the candidate.
​
string
required
Candidate’s full name.
​
string
Professional headline summarising the candidate’s current role and expertise.
​
string
Current city or region in India where the candidate is based.
​
integer
Total years of professional experience across all roles.
​
array of strings
Validated skill tags associated with the candidate’s profile (e.g., Python, React, AWS).
​
number
AI-computed quality score ranging from 0 to 100, based on the candidate’s accomplishments and career trajectory. Higher scores indicate stronger overall profiles.
​
string
Current or most recent employer.
​
string
Current or most recent job title.
​
integer
Minimum expected annual salary in INR.
​
integer
Maximum expected annual salary in INR.
​
string
Current job-search status. One of active, open, or not_looking.
​
string
URL to the candidate’s public Cutshort profile page.

​
Quality scoring

Cutshort’s Quality Grader uses AI to assign every candidate a score from 0 to 100. Unlike simple keyword matching, the Quality Grader evaluates five dimensions:
  • Company pedigree — the calibre of organisations the candidate has worked at
  • Career trajectory — the pace and direction of growth across roles
  • Role complexity — the scope and impact of past responsibilities
  • Accomplishments — quantifiable achievements stated in the profile
  • Skill depth — breadth and specialisation across the validated skill set
This means a candidate with fewer years of experience but a strong trajectory at a well-regarded company can outscore a more tenured candidate with a flat career arc.
Filter your candidate searches with quality_score_min=70 to immediately surface high-signal candidates — those whose profiles indicate consistent career growth and meaningful accomplishments.

​
Skill validation

Cutshort runs a skill-assessment program covering 30+ technical skills, including Python, Java, React, Node.js, AWS, and DevOps tooling. When a candidate completes an assessment, the corresponding skill is marked as verified in the skill object:
Verified skills give you a stronger signal that the candidate can demonstrate hands-on proficiency — not just list the technology on a résumé.
Skills not yet in the validation program still appear on candidate profiles but without the verified: true flag. You can still filter and search on unverified skills; they simply haven’t been assessed yet.

​
Availability signals

Every candidate profile carries one of three availability states that indicate how actively they are looking for new roles:
Target active and open candidates for faster response rates. Candidates in the not_looking state are less likely to engage with unsolicited invites and may slow down your sourcing cycle.

​
Privacy and access

Full contact details — including email address and phone number — are only returned after one of the following conditions is met:
  • The candidate has accepted an invite from your organisation, or
  • Your organisation has sufficient plan credits to unlock the profile.
The search and profile endpoints return public profile data by default. Plan your API usage and credit allocation accordingly before attempting to retrieve contact information at scale.