API Rate Limits

The Wraps Platform API enforces a per-minute rate limit based on your plan. Limits are applied per organization using DynamoDB-backed sliding windows. There is no daily request cap and no monthly send quota on any plan — sends are unlimited and billed by AWS directly. The per-minute limit exists to protect the API from bursts.

Unauthenticated endpoints (health check, public tools) use IP-based rate limiting:

Custom events (sent via POST /v1/events and POST /v1/events/batch) are the one metered resource — they are Wraps' own storage, not AWS sending, which is never metered. Free ingestion continues through a 25% grace margin (6,250 events) before returning 429 with a Retry-After pointing at the 1st of the next month, when the counter resets. Sending is never affected.

Every rate-limited response carries these headers. Read the unprefixed RateLimit-* names — the X- forms are the originals, kept so existing integrations keep working.

HTTP/1.1 200 OKRateLimit-Limit: 500RateLimit-Remaining: 487RateLimit-Reset: 34RateLimit-Policy: 500;w=60X-RateLimit-Limit: 500X-RateLimit-Remaining: 487X-RateLimit-Reset: 34

HTTP/1.1 429 Too Many RequestsRetry-After: 34RateLimit-Limit: 500RateLimit-Remaining: 0RateLimit-Reset: 34RateLimit-Policy: 500;w=60X-RateLimit-Limit: 500X-RateLimit-Remaining: 0{  "error": "Rate limit exceeded: 500 requests per minute",  "code": "RATE_LIMITED",  "requestId": "01JBZ9K3M4N5P6Q7R8S9T0"}

When you receive a 429 status code:

1. Read the Retry-After header for the number of seconds to wait
2. Wait that duration before retrying
3. Use exponential backoff if retries continue to fail

async function fetchWithRetry(url: string, options: RequestInit, maxRetries = 3) {  for (let attempt = 0; attempt < maxRetries; attempt++) {    const response = await fetch(url, options);    if (response.status === 429) {      const retryAfter = Number(response.headers.get('Retry-After') ?? 60);      await new Promise(r => setTimeout(r, retryAfter * 1000));      continue;    }    return response;  }  throw new Error('Rate limit exceeded after retries');}