Rate limits

Live keys allow 100 requests per second; bursts are smoothed with a token bucket.

Updated 2 months ago 2 min read v3

On this page

Live keys allow 100 requests per second; bursts are smoothed with a token bucket. Here is exactly what to do.

Steps#

Watch the headers#
RateLimit-Remaining and RateLimit-Reset come with every response.
Back off on 429#
Wait for the number of seconds in Retry-After.
Batch where you can#
POST /v3/messages/batch sends up to 500 messages in one call.

Tip

Need more? Business plans can raise limits to 1,000 requests per second.

Include the request ID from the Relay-Request-Id response header — it lets us find your call in seconds.

Was this article helpful?