# Cutshort API

> Search India's tech talent database programmatically.

## Docs

- [Introduction](https://developers.cutshort.io/introduction.md): Search India's tech talent with the Cutshort Public API
- [Authentication](https://developers.cutshort.io/authentication.md): API keys, scopes, and request headers
- [Quickstart](https://developers.cutshort.io/quickstart.md): Your first talent search in two minutes
- [MCP Server](https://developers.cutshort.io/guides/mcp-server.md): Connect Claude, Cursor, or any MCP client to Cutshort
- [Search candidates](https://developers.cutshort.io/guides/search-candidates.md): Structured filters, AI search, and resume boolean queries
- [Get candidate details](https://developers.cutshort.io/guides/get-candidate-details.md): Contact info, resume file, and auto-unlock credits
- [Profile signals](https://developers.cutshort.io/guides/profile-signals.md): AI-evaluated pedigree, quality, and industry tags on search hits
- [Post a job](https://developers.cutshort.io/guides/post-a-job.md): Create a job with auto-configured pipeline and outreach
- [List workspace jobs](https://developers.cutshort.io/guides/list-jobs.md): Get your active jobs and their IDs for use in search and outreach
- [Invite to apply](https://developers.cutshort.io/guides/invite-to-apply.md): Outreach shortlisted candidates with an invite to apply to your job
- [Send a message](https://developers.cutshort.io/guides/send-message.md): Reply in an existing candidate conversation thread
- [List job stages](https://developers.cutshort.io/guides/list-stages.md): See pipeline stages and application counts for a job
- [List applications](https://developers.cutshort.io/guides/list-applications.md): List candidates in a job stage with fitment filter and optional auto-unlock
- [Move application stage](https://developers.cutshort.io/guides/move-application-stage.md): Move a candidate to another pipeline stage
- [Rate limits and quotas](https://developers.cutshort.io/guides/rate-limits.md): Burst limits, cycle quotas, and error handling
- [Search talent database](https://developers.cutshort.io/api-reference/search/search-talent-database.md): Structured and/or AI/NLP talent search. Hits carry triage data only (headline, experience, profileSignals, redacted resume excerpt) — no names, email, or phone. Use GET /candidates/{talentCardId} for identity (auto-unlocks).
- [Get candidate detail (auto-unlock)](https://developers.cutshort.io/api-reference/candidates/get-candidate-detail-auto-unlock.md): Returns full candidate identity, the actual resume (text + signed file download URL), and structured profile. If the candidate is locked for your workspace, this call unlocks them first — spending **one unlock credit** against the workspace unlock quota (check GET /usage). Already-unlocked candidate…
- [List workspace jobs](https://developers.cutshort.io/api-reference/jobs/list-workspace-jobs.md): Lists your workspace's jobs. Requires scope `jobs:read` (eval + production keys).
- [Post a job](https://developers.cutshort.io/api-reference/jobs/post-a-job.md): Creates a fully configured job from minimal input: skills/tags derived from the JD, screening questionnaire auto-attached, and auto-outreach to matching candidates enabled. After posting, the job is reviewed and then goes live — typically ~30 minutes on business days; matching-candidate outreach sta…
- [Delete a job (soft-delete)](https://developers.cutshort.io/api-reference/jobs/delete-a-job-soft-delete.md): Soft-deletes a job the same way the Cutshort UI does. Deleted jobs no longer appear in GET /jobs. Requires `jobs:write`. Optional body: `reason` + `reasonText` (defaults to cleanup / Public API).
- [Invite a candidate to apply](https://developers.cutshort.io/api-reference/outreach/invite-a-candidate-to-apply.md): FIRST CONTACT only: invites a talent-database / search candidate to apply to one of your jobs, with your custom message. Tip: include an interview booking link so interested candidates can pick a slot. One invite per (job, candidate) pair — if already invited or already in the job pipeline, returns…
- [Send a follow-up message in a thread](https://developers.cutshort.io/api-reference/outreach/send-a-follow-up-message-in-a-thread.md): Sends a reply in an EXISTING conversation thread (candidates already in the job pipeline). Get threadId from GET /jobs/{jobId}/applications or from the invite-to-apply response when present. This is NOT first-contact outreach — use POST /invite-to-apply for search candidates not yet in the pipeline.
- [Move an application to another stage](https://developers.cutshort.io/api-reference/applications/move-an-application-to-another-stage.md): Moves one application to a different pipeline stage on the same job. Get applicationId from GET /jobs/{jobId}/applications and stageId from GET /jobs/{jobId}/stages. From the Applications stage (type candidates), only Shortlisted (connected) or Rejected are valid — other targets return 400 invalid_s…
- [List applications in a job stage](https://developers.cutshort.io/api-reference/applications/list-applications-in-a-job-stage.md): Lists applications for one stage (default: applications / candidates). Fitment filter default strong,fair (excludes weak/not_a_fit); pass fitment=strong or fitment=strong,fair,weak. autoUnlock default true unlocks locked candidates on the page; autoUnlock=false returns only already-unlocked applicat…
- [API usage meters](https://developers.cutshort.io/api-reference/usage/api-usage-meters.md): Returns the workspace's cycle usage as used/limit meter pairs for unlocks, searches (structured + AI combined), and candidate messages. `cycleEndsOn` is when usage resets; `planExpiresOn` is when the subscription ends (non-free plans). Check before spending unlocks or messages. No special scope — an…
- [List stages for a job (with application counts)](https://developers.cutshort.io/api-reference/stages/list-stages-for-a-job-with-application-counts.md): Returns the job pipeline stages with applicationCount per stage. Use stageId with GET /jobs/{jobId}/applications to list a specific stage. Requires scope `jobs:read` (eval + production keys).

## OpenAPI Specs

- [public-api-v1](https://developers.cutshort.io/openapi/public-api-v1.json)