API usage meters
curl --request GET \
--url https://cutshort.io/api/v1/usage \
--header 'Authorization: Bearer <token>'import requests
url = "https://cutshort.io/api/v1/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cutshort.io/api/v1/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"workspaceId": "<string>",
"apiUnlocks": {
"used": 123,
"limit": 123
},
"searches": {
"used": 123,
"limit": 123
},
"messages": {
"used": 123,
"limit": 123
},
"cycleEndsOn": "<string>",
"planExpiresOn": "<string>"
}{
"error_code": "<string>",
"error_description": "<string>"
}Usage
API usage meters
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 — any valid API key.
GET
/
usage
API usage meters
curl --request GET \
--url https://cutshort.io/api/v1/usage \
--header 'Authorization: Bearer <token>'import requests
url = "https://cutshort.io/api/v1/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cutshort.io/api/v1/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"workspaceId": "<string>",
"apiUnlocks": {
"used": 123,
"limit": 123
},
"searches": {
"used": 123,
"limit": 123
},
"messages": {
"used": 123,
"limit": 123
},
"cycleEndsOn": "<string>",
"planExpiresOn": "<string>"
}{
"error_code": "<string>",
"error_description": "<string>"
}Authorizations
Workspace-scoped API key. Prefix: cs_live_. Eval keys (self-serve from Cutshort → Settings → Integrations → API Key) can search and get candidate details within small quotas; production keys add job posting and candidate messaging with higher limits.
