Docs

Rate limits

Limits keep one app from slowing the others. They are generous for normal use; plan for a 429 anyway.

The limits

WhatLimit
API calls600 per minute for each app in each tenant (fixed one-minute window). Stracker may set another value for an app.
Token endpoint30 per minute for each client and IP address. Reuse a token until it expires instead of requesting one per call.
Webhook test events10 per minute for each subscription.
Webhook subscriptions10 per app in a tenant, 20 per tenant, 30 event types each.
Webhook payloadAt most 64 KiB.
Page sizelimit has a maximum per list; see the operation in the reference.

Headers

Every API answer carries the state of your window: RateLimit-Limit (calls allowed), RateLimit-Remaining (calls left) and RateLimit-Reset (seconds until the window resets).

HTTP
HTTP/1.1 200 OK
RateLimit-Limit: 600
RateLimit-Remaining: 597
RateLimit-Reset: 41

When you get a 429

HTTP
HTTP/1.1 429 Too Many Requests
RateLimit-Limit: 600
RateLimit-Remaining: 0
RateLimit-Reset: 23
Retry-After: 23
Content-Type: application/problem+json
  • The body is 429 RATE_LIMITED. Wait at least Retry-After seconds before you call again.
  • Retry writes with the same Idempotency-Key (idempotency).
  • Spread work out: lower your polling rate, page through large lists instead of fetching them in parallel, and use webhooks instead of polling for changes.
  • If your integration needs more, tell us what it does and why; we can raise the limit for an app.