Usage Limits
Taggun's API rate limits, what happens when you reach them, and how scans are counted.
Taggun publishes the following request-rate limits. Treat these figures as integration guidance; the public documentation does not define gateway window implementation or limit scope.
Rate Limits
| Type of limit | Usage limit |
|---|---|
| Requests per second | 5 |
| Requests per minute | 300 |
| Requests per hour | 2,000 |
| Maximum HTTP request body | 20 MiB (20,971,520 bytes), inclusive |
What Happens at the Limit
Requests over a rate limit can return 429 Too Many Requests with { "message": "API rate limit exceeded" }. Retry with exponential backoff rather than resubmitting immediately. A 429 response may omit Retry-After; honour that header when present, but do not rely on it being supplied. See Error Handling & Status Codes.
If you are running batch jobs, pace submissions conservatively against all three published figures — 5 requests/second, 300/minute, and 2,000/hour — and leave headroom for other traffic. The hourly figure is approximately 0.556 requests/second when averaged evenly across an hour, but that arithmetic is not a gateway scheduling contract. The published figures do not establish rolling versus fixed windows or whether every limit has the same scope.
The size limit measures the complete HTTP request body. Multipart framing and encoded JSON/base64 expansion count toward 20 MiB; a body one byte over the limit returns 413. See Document Types & File Requirements for the implications for files and URL-based submissions.
Scans and Billing
One file = one scan = one API request. A scan is counted once the request is processed — including receipts that fail validation or are flagged by fraud checks. Requests that error before processing are not counted. Each plan includes a monthly scan volume, with per-scan overage after that — see the pricing page for volumes and rates.
For self-service plans, the first 30 days or first 1,000 scans, whichever comes first, are free. When either limit is reached, the selected plan becomes paid and billing starts. Enterprise evaluation is arranged separately.
Need Higher Limits?
If the published limits do not fit your workload, contact us via Plans & Feature Access or [email protected] to discuss your requirements and the options currently available.
Need something not covered here? Contact [email protected] — see Contacting Support.
Updated 15 days ago