Rate limits and pagination
Request limits and how to page through lists.
Rate limits
Limits apply to your whole team, so every key shares them:
| Keys | Requests per minute |
|---|---|
| Live | 600 |
| Test | 120 |
Every response includes your current limit:
| Header | Meaning |
|---|---|
RateLimit-Limit | Requests allowed in the current window |
RateLimit-Remaining | Requests left in the current window |
RateLimit-Reset | Seconds until the window resets |
When you go over the limit you get a 429 with a Retry-After header. Wait that many seconds before trying again.
Pagination
List endpoints return a page of results and a cursor:
{
"data": [],
"next_cursor": "cur_123"
}Pass next_cursor as ?cursor= to get the next page. When it's null, you've reached the end. Use ?limit= to set the page size, up to 100.