# Limits and credits

> How credits are consumed, request size and batch limits, timeouts and concurrency guidance for the HireLayer APIs.

Source: https://onlineresumeparser.com/api-docs/limits · Markdown: https://onlineresumeparser.com/api-docs/limits.md

## Credits

- 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 `403` with `"error": "Insufficient credits available"`.

## Request limits

| 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 `id`s |
| Skills | `skills` ≤ 100 items · `top_k` 1–50 |
| All JSON endpoints | Body ≤ 10 MB |

## Timeouts

| 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 |

## Rate limits and concurrency

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](https://cal.com/resumeparser/demo-resume-parser) first.

## Next

- [Errors and retries](https://onlineresumeparser.com/api-docs/errors.md): Error format, every status code and message, and when to retry a HireLayer API call.
- [Build a screening pipeline](https://onlineresumeparser.com/api-docs/screening-pipeline.md): Chain HireLayer CV Extract, Job Extract, Rank and Match to parse resumes, score them against a job and explain the result.