# Cutshort

## Docs

- [GET /candidates/{id} — Look Up a Candidate by ID](https://developers.cutshort.io/api-reference/candidates/get.md): Retrieve a candidate's summary record by their Cutshort ID. Returns name, location, skills, quality score, and availability status.
- [GET /candidates/{id}/profile — Full Candidate Profile](https://developers.cutshort.io/api-reference/candidates/profile.md): Retrieve a candidate's complete Cutshort profile: work history, education, projects, and verified skills. Contact details require invite acceptance.
- [GET /candidates/search — Search the Cutshort Talent Pool](https://developers.cutshort.io/api-reference/candidates/search.md): Search 4M+ Indian tech professionals by skills, experience, location, salary expectation, availability, and AI quality score. Returns paginated results.
- [Cutshort API Error Codes: HTTP Status and Troubleshooting](https://developers.cutshort.io/api-reference/errors.md): HTTP status codes and error response shapes for the Cutshort API. Handle validation errors, auth failures, rate limits, and server errors gracefully.
- [POST /jobs — Create a New Job Posting on Cutshort](https://developers.cutshort.io/api-reference/jobs/create.md): Create a job posting on Cutshort. Once created, the AI matching engine begins generating a candidate shortlist based on the job's requirements.
- [GET /jobs — List and Filter Your Organization Jobs](https://developers.cutshort.io/api-reference/jobs/list.md): List all job postings for your organization. Filter by status to view active, paused, or closed roles. Returns job metadata and shortlist counts.
- [PATCH /jobs/{id} — Partially Update or Close a Job](https://developers.cutshort.io/api-reference/jobs/update.md): Update a job posting's fields or change its status. Use status=closed to close a role, or status=paused to temporarily halt candidate sourcing.
- [Cutshort REST API: Candidates, Jobs, and Sourcing Endpoints](https://developers.cutshort.io/api-reference/overview.md): Complete reference for the Cutshort REST API. Authenticate with an API key and access endpoints for candidates, jobs, sourcing, and webhooks.
- [Cutshort API Rate Limits: Quotas, Headers, and Backoff Guide](https://developers.cutshort.io/api-reference/rate-limits.md): Cutshort API rate limits by endpoint, response headers for quota tracking, and best practices including exponential backoff to stay within your limits.
- [POST /sourcing/invite — Send Candidate Outreach Invites](https://developers.cutshort.io/api-reference/sourcing/invite.md): Send WhatsApp and email outreach invites to shortlisted candidates for a job. Invites include job details and a one-click response link.
- [POST /sourcing/shortlist — Generate Candidate Shortlist](https://developers.cutshort.io/api-reference/sourcing/shortlist.md): Request an AI-generated candidate shortlist for a job. Cutshort ranks the best-fit candidates by match score from a pool of 4M+ verified profiles.
- [Webhooks — Configure Endpoints, Signatures, and Retries](https://developers.cutshort.io/api-reference/webhooks/configure.md): Programmatically register, list, and delete Cutshort webhook endpoints. Covers request body params, signature verification, and automatic retry behavior.
- [Webhook Events — Cutshort Event Types and Payloads](https://developers.cutshort.io/api-reference/webhooks/events.md): Reference for all Cutshort webhook event types. Covers payload shapes for candidate, invite, offer, and job events that fire in your hiring pipeline.
- [Cutshort API Authentication – API Keys & Bearer Tokens](https://developers.cutshort.io/authentication.md): Generate a Cutshort API key, pass it as a Bearer token, manage keys across environments, and handle authentication errors like 401 and 403.
- [Candidates: Cutshort's Verified Tech Talent Profiles](https://developers.cutshort.io/concepts/candidates.md): Understand how Cutshort represents candidates, what data is available, and how the AI quality scoring system surfaces the best-fit engineers.
- [Jobs: AI-Powered Role Matching and Management in Cutshort](https://developers.cutshort.io/concepts/jobs.md): Learn how Cutshort job objects work, what fields drive AI-powered candidate matching, and how to write descriptions that produce high-quality shortlists.
- [Sourcing: AI-Driven Candidate Discovery on Cutshort](https://developers.cutshort.io/concepts/sourcing.md): Understand how Cutshort's sourcing engine works — from AI-powered shortlisting to bulk outreach — and how to trigger sourcing workflows via the API.
- [Integrate Cutshort with Your Applicant Tracking System](https://developers.cutshort.io/guides/ats-integration.md): Connect Cutshort to your applicant tracking system to automatically push shortlisted candidates, stage updates, and offer details.
- [Create and Manage Job Postings on Cutshort via the API](https://developers.cutshort.io/guides/post-jobs.md): Programmatically create job postings on Cutshort, manage their status lifecycle, and trigger AI candidate matching for each open role.
- [Search Candidates by Skills, Experience, and Location](https://developers.cutshort.io/guides/search-candidates.md): Use the Cutshort API to search 4M+ Indian tech professionals by skills, experience, location, salary expectations, and AI quality score.
- [Receive Real-Time Hiring Events with Cutshort Webhooks](https://developers.cutshort.io/guides/webhooks.md): Configure Cutshort webhooks to receive real-time notifications when candidates are shortlisted, stages change, or offers are made.
- [Cutshort API – What to Build & How the Platform Works](https://developers.cutshort.io/introduction.md): Discover what to build with Cutshort's REST API and MCP server — ATS integrations, AI hiring agents, and more — backed by 4M+ verified tech professionals.
- [Cutshort MCP Server: AI-Powered Hiring Tools for Agents](https://developers.cutshort.io/mcp/overview.md): The Cutshort MCP server exposes candidate search, job management, and sourcing as tools that AI agents like Claude and GPT-4 can call directly.
- [Cutshort MCP Server Setup: Configure Claude and Cursor](https://developers.cutshort.io/mcp/setup.md): Install the Cutshort MCP server via npm and connect it to Claude Desktop, Cursor, or any MCP-compatible AI client in under five minutes.
- [Cutshort MCP Tools Reference: Parameters and Examples](https://developers.cutshort.io/mcp/tools.md): Complete reference for all 5 Cutshort MCP tools: search_candidates, get_candidate_profile, create_job, get_shortlist, and send_invite.
- [Cutshort API Quickstart – First API Call in 5 Minutes](https://developers.cutshort.io/quickstart.md): Create your Cutshort account, generate an API key, and search 4M+ Indian tech candidates with your first REST API call in under 5 minutes.