Rate Limits
The API applies request limits by endpoint and caller IP. These server-side limits are separate from any plan usage quotas.
Limits by plan
| Endpoint group | Limit | Window | Basis |
|---|---|---|---|
| General API | 200 requests | 1 minute | Caller IP |
| IP lookups | 60 requests | 1 minute | Caller IP |
| Report submissions | 20 requests | 1 hour | Caller IP |
| Authentication | 10 requests | 15 minutes | Caller IP |
Response headers
Rate-limit headers are returned on limited responses:
| Header | Description |
|---|---|
| X-RateLimit-Limit | Max requests in the current window |
| X-RateLimit-Remaining | Requests left in the current window |
| X-RateLimit-Reset | Unix timestamp when the window resets |
| Retry-After | Seconds to wait (only present on 429 responses) |
Handling 429 Too Many Requests
When you exceed the per-minute limit the API returns HTTP 429. Use the Retry-After header to wait the correct amount of time:
TypeScript
async function lookupWithRetry(ip: string, retries = 3): Promise<Response> {
const res = await fetch(`https://api.ipabuse.org/v1/ip/${ip}/`, {
headers: { "X-API-Key": process.env.IPABUSE_API_KEY! },
});
if (res.status === 429 && retries > 0) {
const retryAfter = Number(res.headers.get("Retry-After") ?? 1);
await new Promise((r) => setTimeout(r, retryAfter * 1000));
return lookupWithRetry(ip, retries - 1);
}
return res;
}Burst allowance
All plans include a short burst allowance of up to 2× the per-minute limit for up to 5 seconds. Sustained traffic above your plan limit will be throttled.
Need more?
Upgrade your plan at ipabuse.org/billing or contact us for a custom Enterprise quote.
Next steps
- Error Reference — all error codes explained.
- Webhooks — get notified instead of polling.