Cutshort REST API: Candidates, Jobs, and Sourcing Endpoints

The Cutshort REST API gives you programmatic access to India’s largest premium tech talent pool. Use it to search candidates, manage job postings, trigger AI-powered shortlisting, and configure webhooks — all with standard HTTP requests and JSON responses.

Base URL

https://api.cutshort.io/v1

All endpoints use HTTPS. HTTP requests are automatically redirected.

Authentication

Include the following headers on every request:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

See the Authentication page for details on generating and managing your API key.

Request Format

All requests and responses use JSON.
Set Content-Type: application/json on all POST and PATCH requests.
Query parameters are used for GET filters.

Response Format

A standard success response looks like this:

{
  "data": { ... },
  "meta": {
    "total": 412,
    "page": 1,
    "per_page": 20
  }
}

A standard error response looks like this:

{
  "error": {
    "code": "validation_error",
    "message": "skills parameter is required",
    "details": [
      { "field": "skills", "issue": "missing required parameter" }
    ]
  }
}

Endpoints Summary

Method	Endpoint	Description
`GET`	`/candidates/search`	Search candidates by filters
`GET`	`/candidates/{id}`	Get a candidate by ID
`GET`	`/candidates/{id}/profile`	Get full candidate profile
`GET`	`/jobs`	List your organization’s jobs
`POST`	`/jobs`	Create a new job
`PATCH`	`/jobs/{id}`	Update a job
`POST`	`/sourcing/shortlist`	Generate a candidate shortlist
`POST`	`/sourcing/invite`	Send invites to candidates
`GET`	`/webhooks`	List webhook endpoints
`POST`	`/webhooks`	Register a webhook

Versioning

The current API version is v1. Breaking changes will be announced with a new version prefix. The v1 endpoints will remain available for at least 12 months after any v2 launch.

Overview

Candidates

Jobs

Sourcing

Webhooks

Cutshort REST API: Candidates, Jobs, and Sourcing Endpoints

Base URL

Authentication

Request Format

Response Format

Endpoints Summary

Versioning

​Base URL

​Authentication

​Request Format

​Response Format

​Endpoints Summary

​Versioning

Base URL

Authentication

Request Format

Response Format

Endpoints Summary

Versioning