Docs · API · Usage
Usage & credits.
Pricing is per operation, not per token. One credit = one standard CV screen. Credits are debited when work is accepted and refunded automatically if the run fails.
What things cost#
| Field | Type | Description |
|---|---|---|
| CV screen (standard) | 1 credit | Per CV in a screening run: parse + anonymize + rubric scoring, evidence pass on the top slice. |
| CV screen (deep) | 3 credits | Evidence pass on every CV, not just the top slice. Set mode: "deep" on the screen call. |
| Interview kit | 12 credits | Per candidate — the full 30-minute CV-grounded kit. |
| JD generation | free | Job creation, regeneration, and the Arabic version cost nothing (fair-use rate limited). |
| Publish / distribute | free | Career page, Google for Jobs, and board feeds. |
| Bulk CV intake | free | POST /v1/cvs stores files only; the charge happens at screening time. |
A screening of 87 CVs in standard mode therefore charges exactly 87 credits — the screen call returns credits_charged up front, and the whole amount is refunded if the run fails.
Where credits come from#
- Plan grants — monthly credits sized to your tier (Free 50 · Starter 420 · Growth 2,220 · Scale 9,000).
- Credit packs — top-ups that never conflict with plan grants; unused pack credits roll over.
- Refunds— failed runs credit back automatically; you never pay for work that didn't finish.
Your live balance is on the dashboard and in every GET /v1/usage response. When an operation would exceed the balance, the API returns 402 insufficient_credits before creating anything — see Errors.
The usage endpoint#
GET
/v1/usage| Query | Type | Description | |
|---|---|---|---|
| days | integer | default: 30 | Reporting window, capped at 90. |
curl "https://hire.whizztech.ai/v1/usage?days=7" \
-H "Authorization: Bearer $HIRE_KEY"{
"object": "usage",
"days": 7,
"credit_balance": 1418,
"daily": [
{
"day": "2026-07-08",
"credits": 87,
"requests": 6,
"tokens_in": 412650,
"tokens_out": 58210
},
{
"day": "2026-07-09",
"credits": 24,
"requests": 3,
"tokens_in": 96110,
"tokens_out": 31480
}
]
}| Field | Type | Description |
|---|---|---|
| credit_balance | integer | Current balance across all grants, purchases, debits, and refunds. |
| daily[].credits | integer | Credits consumed that day. |
| daily[].requests | integer | Billable operations that day (runs, not HTTP requests). |
| daily[].tokens_in / tokens_out | integer | Raw model token usage behind your operations — transparency, not billing; you are never charged per token. |