Rate Limiting
Rate limits apply to all authenticated v3 API endpoints. Limits are per minute and match the tiers shown in your subscription dashboard. The counter resets at the start of each minute.
Subscription Tiers
| Tier | Requests/Minute | Description |
|---|---|---|
| Free | 100 | 100 API requests/minute |
| Professional | 500 | 500 API requests/minute |
| Enterprise | 1,000 | 1000 API requests/minute |
| Elite | 10,000 | 10,000 API requests/minute |
Rate Limit Exceeded Response
When you exceed your rate limit, you'll receive a 429 Too Many Requests response:
JSON Response
{
"success": false,
"error": "Rate limit exceeded",
"error_code": "RATE_LIMIT_EXCEEDED",
"details": {
"message": "You have exceeded your per-minute request limit",
"tier": "TierName",
"requests_used": 100,
"requests_limit": 100,
"upgrade_url": "https:\/\/swiftwallet.co.ke\/subscription.php"
}
}