Usage & Plans
Monthly quotas, shared limits across API keys, and upgrading your plan.
How quota works
ToolYour enforces limits per account, not per API key:
| Concept | Behavior |
|---|---|
| Billing period | Calendar month (resets on the 1st) |
| Monthly allowance | One shared limit for your entire account |
| All API keys | Every successful tool call counts toward the same allowance |
| Per-key stats | Dashboard shows calls per key for visibility only |
Creating multiple keys does not multiply your quota. Use separate keys for environments (dev/staging/prod), not to increase limits.
Plans
| Plan | Requests / month | Rate limit (Free) |
|---|---|---|
| Free | 500 | 5 requests / rolling minute |
| Pro | 20,000 | Higher throughput |
| Business | 100,000 | Highest throughput |
View current pricing and subscribe from Dashboard → Billing on toolyour.com.
What counts as usage
Only successful tool API calls (with X-Api-Key) count toward your monthly limit. Failed requests (4xx validation errors) generally do not.
Platform actions — login, creating keys, viewing the dashboard — do not consume tool quota.
When you hit the limit
Tool endpoints return 429 Too Many Requests with a monthly quota or rate-limit message. Options:
- Wait until the next billing month
- Upgrade your plan from the dashboard
- Reduce call volume or cache results
Track usage
See Dashboard → Overview and Dashboard → API Keys for current-period usage and remaining quota. There is no need to call separate usage APIs from your integration — the dashboard is the source of truth for billing.