API Reference

Rate limits

Request quotas for the Two Minute Reports API and how to handle the 429 Too Many Requests response.

The API enforces rate limits to keep the service responsive for everyone. Limits are applied per client.

Global limit

By default, every endpoint allows 120 requests per 60 seconds.

Some endpoints have tighter limits because they are sensitive or expensive. These override the global limit:

Endpoint	Limit
`POST /teams/{teamId}/data/run-query`	30 requests / 60 seconds
`POST /teams/{teamId}/members/invite`	15 requests / 5 minutes
`PUT /users/me/avatar`	10 requests / 5 minutes

When you exceed a limit, the API responds with 429 Too Many Requests:

{
  "success": false,
  "error": {
    "code": "TOO_MANY_REQUESTS",
    "message": "Too many requests — please slow down and try again later"
  }
}

Back off and retry after a short delay when you receive a 429. For batch workloads, spread requests out rather than sending them in a tight loop.

Authentication

Authenticate Two Minute Reports API requests with a bearer token, and learn how to create one.

Errors

The Two Minute Reports API error envelope, status codes, and machine-readable error codes.