Skip to content
RelayDocumentation

API ReferenceOverview

Rate limits

How many requests you can make, and how to handle 429 responses.

Rate limits protect the API from bursts that would slow down everyone. They apply per account and per mode.

PlanSend eventsOther requests
Free50 / second25 / second
Pro500 / second100 / second
ScaleCustom250 / second

Headers

Every response tells you where you stand:

RateLimit-Limit: 500
RateLimit-Remaining: 487
RateLimit-Reset: 1

Handling 429

When you go over the limit, the API responds with 429 Too Many Requests and a Retry-After header in seconds. The SDKs wait and retry automatically (up to maxRetries).

Sending a large backlog? Use batch sending: one request can carry up to 100 events and counts as one request.