Platform
All limits
Every limit that applies to the Tomba API, in one place. Each row links to the page that defines the limit and its current value.
Limits
| Limit | Value or where to find it | Defined on |
|---|---|---|
| Request body size | 4 MB. Larger bodies fail with 413. | This page |
| Request duration | 180 seconds. Longer requests end with 504 from the gateway. | This page |
| Requests per second, minute, and day | Per plan and per endpoint. GET /v1/rate-limits returns the values for your account. | Limits by plan |
| Endpoints with a fixed rate limit | Company search, API keys, and flags have the same limit on every plan. | Endpoints with fixed limits |
| Credit allowances | Search, verification, email count, and sources credits per usage window, by plan. GET /v1/me returns yours. | Quotas |
| Credits per request | Per endpoint | Credit costs |
| Free repeat requests | Same request within the usage window | Duplicate requests |
| Free plan results | Domain search result count and pages; company search pages | Free plan limits |
| Workspace member credits | Optional per-member search and verification limits set by the owner | Quotas |
| Workspace members | pricing.available_teams in GET /v1/me | API reference |
| Rows per bulk job | Per bulk type | Bulk types |
| Bulk jobs created, running at once, downloads | Per bulk type and per job | Bulk limits |
| Page size of paginated endpoints | Per endpoint | Pagination |
| Active API keys | pricing.available_keys in GET /v1/me | Authentication |
| API key lifetime | Set per key, up to a maximum | Key expiry |
| OAuth token lifetime | Access and refresh tokens | OAuth 2.0 |
| Leads and lead lists | pricing.available_leads and pricing.available_list in GET /v1/me | API reference |
| Lead attributes | Per account | Create a lead attribute |
| Webhook callback timeout and retries | Per delivery attempt | Delivery |
| Remote MCP server | Plan rate limits and credits, plus the server's own retries | Limits and billing |
| Pay per request (agents.tomba.io) | Shared across all agents | Rate limits |
A request over a rate limit or a daily bulk limit fails with 429. A request over a credit balance fails with 402, or with 429 for the email count and sources balances. A request over an account cap on keys, leads, lead lists, or lead attributes fails with 422. See Errors.
Last modified on