Credits and billing

Plans are a fixed monthly price in INR with a monthly credit allowance. Each call spends a known number of credits, so you can price your own product on top of it.

What a call costs

Call	Credits
`POST /v1/search` (summary results)	1
Each full record in `search` or `match` with `expand: true`, or `GET /v1/candidates/{id}`	5
`GET /v1/candidates/{id}/cv` (10-minute resume link)	2
`POST /v1/parse/resume`, `POST /v1/parse/jd`	2
`POST /v1/fit` (one candidate against one job description)	3
`POST /v1/match` (a job description against the pool)	10
Market data, jobs, `/v1/me`, `/v1/usage`, webhooks, checkout	Free

Example: search with limit: 10 and expand: true costs 1 + 10 × 5 = 51 credits. The exact charge is returned in the x-credits-charged header on every response, and by endpoint in GET /v1/usage.

Plans

Plan	Price / month	Credits / month	Requests / min	Top-up
Pro	₹14,999	3,000	60	1,000 credits for ₹6,000
Pro Scale	₹49,999	15,000	300	1,000 credits for ₹4,000
Client	By arrangement	Custom	120	n/a

Prices exclude GST. 18% GST is added at checkout and shown before you pay.

Periods

A period is 30 days. It starts when a payment succeeds, not on a calendar date.
Credits reset at the start of each period and do not roll over.
Paying early starts a fresh 30-day period immediately and resets used credits to zero. Pay when you are low, not on the last day, and you lose nothing you would have used.
After a period ends you have a 5-day grace window in which the key keeps working. After that calls return 402 subscription_inactive until you renew. Checkout always works, even on an expired key.

Top-ups

Pro and Pro Scale can add credits mid-period in packs of 1,000, up to 20 packs per purchase. Top-up credits are spent after the monthly allowance and stay valid until the end of the period after the current one, so they survive one renewal.

Paying

Payment is by UPI, card or netbanking through Cashfree. Start it from your own code, then send the user (or your finance team) to the returned link:

Start a plan payment

curl https://api.helixhumancapital.in/v1/billing/checkout \
  -H "Authorization: Bearer $HELIX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "plan", "plan": "pro", "phone": "9876543210"}'

# {"orderId":"hlxapi_…","amountInr":17698.82,"payUrl":"https://…/api-billing/pay?session=…"}

A top-up is {"kind":"topup","packs":2,"phone":"…"}. When Cashfree confirms the payment the key is credited exactly once. If your system is notified by webhook you will receive subscription.renewed; see Webhooks. Larger or invoiced arrangements are set up by us, not self-serve.

Staying ahead of limits

Subscribe to credits.low (at 20% remaining) and credits.exhausted webhooks and top up automatically or alert a human.
Handle 402 insufficient_credits in code: the body includes needed (credits this call costs) and topUpAt.
Poll GET /v1/me (free) before a large batch.

← PreviousAuthentication and scopes Next →Rate limits and errors