Get started
Limits and credits
How credits are consumed, request size and batch limits, timeouts and concurrency guidance for the HireLayer APIs.
- 1 successful API call = 1 credit across every API. One Rank call costs 1 credit for up to 10 candidates; one Skills batch costs 1 credit for up to 100 skills.
- Failed calls (non-2xx) are free. The health check is free.
- Exception: legacy CV Extract V2 charges when the request is accepted (
202). - Plans: Free: 50 credits/month · Starter: 500 credits/month · Scale: 2,000 credits/month; Enterprise on request. Credit packs are available from the dashboard.
- Without credits, calls return
403with"error": "Insufficient credits available".
| Product | Limit |
|---|---|
| CV Extract | One file per call, about 4.5 MB (6 MiB encoded) · 100,000 extracted characters · OCR on the first 4 pages of scans |
| Job Extract | job_text ≤ 50,000 characters |
| Match | job_text and candidate_text ≤ 50,000 characters each · no fixed criteria limit |
| Rank | 1–10 candidates · each text ≤ 50,000 characters · unique ids |
| Skills | skills ≤ 100 items · top_k 1–50 |
| All JSON endpoints | Body ≤ 10 MB |
| Endpoint | Gateway timeout | Client timeout to use |
|---|---|---|
POST /api/v3/parser | 145 s (504) | ≥ 150 s |
/api/v1/* | 60 s (502) | ≥ 65 s |
POST /api/v2/parser (legacy) | 45 s | ≥ 50 s |
No per-second rate limit is enforced, but capacity is shared. Start with a few concurrent requests, increase gradually while watching latency, and back off on 502, 503 and 504. For sustained high volumes or bulk imports, contact us first.