Rate Limits
Talonic API rate limits by API tier: the Free plan includes a 5,000-credit monthly grant; paid tiers get per-namespace daily request limits and larger file caps.
Talonic API rate limits depend on your API tier, the throughput axis that comes with your Plan. The Free plan is metered by a recurring 5,000-credit monthly grant (no card required) that refreshes on the 1st of each month (UTC). Paid tiers are metered by per-namespace daily request limits that reset at midnight UTC. Every response carries X-RateLimit-* headers so you always know how much headroom remains.
Free plan: monthly credit grant
Free workspaces spend from the monthly credit envelope rather than a hard request cap. Requests run until the credit balance is spent, then return 402 INSUFFICIENT_CREDITS until the next grant. A generous daily request ceiling is retained purely as abuse protection and does not bind a legitimate free user within the monthly envelope. Check your balance and reset date with [GET /v1/account](get-account).
Paid tiers: daily request limits
Paid tiers are limited per API namespace (extract, platform, ingest) per calendar day (UTC):
- Free — 5,000 credits/month across all namespaces; daily ceilings apply only as abuse protection.
- Pro — 2,000 extract requests/day, 10,000 platform requests/day, 2,000 ingest requests/day.
- Enterprise — Unlimited requests across all namespaces.
Maximum file size per tier
- Free — 20 MB per uploaded file.
- Pro — 100 MB per uploaded file.
- Enterprise — 500 MB per uploaded file (the platform maximum).
Uploads over your tier's cap are rejected with 413 FILE_TOO_LARGE before any processing starts, so an oversized file never consumes credits.
Rate limit headers
Every API response includes rate limit headers:
X-RateLimit-Limit— Daily request cap for the namespace you called.X-RateLimit-Remaining— Requests remaining in the current window.X-RateLimit-Reset— ISO 8601 timestamp when the rate limit window resets (midnight UTC).
Rate limit headers example
To check headroom without making a metered call, use [GET /v1/account](get-account): it returns your daily_limits per namespace (-1 means unlimited) and usage_today, plus your credit balance and, on the Free plan, the grant reset date.
429 response carries the error code QUOTA_EXCEEDED and retryable: true. Wait until the X-RateLimit-Reset timestamp before retrying, and add exponential backoff for anything else marked retryable.