Rate Limits

Monitor and manage API rate limits per API key.

Every API key has three rate limit tiers: hourly (100), daily (1,000), and monthly (10,000). These limits apply to the /v1/send endpoint.

When you exceed a rate limit, the API returns a 429 status code. Check the response headers for current usage:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1719849600
GET/rate-limits/:apiKeyIdJWT

Get current rate limit usage for an API key.

ParameterTypeInDescription
apiKeyIdrequiredstringpathAPI key ID

Response

json
{
  "hourly": {
    "limit": 100,
    "remaining": 87,
    "resetAt": "2025-06-01T13:00:00Z"
  },
  "daily": {
    "limit": 1000,
    "remaining": 945,
    "resetAt": "2025-06-02T00:00:00Z"
  },
  "monthly": {
    "limit": 10000,
    "remaining": 9876,
    "resetAt": "2025-07-01T00:00:00Z"
  }
}