API reference

Rate limits

Per-minute limits per project and per end user, the headers that report them, and 429s.

Limits#

Per minute, in fixed one-minute windows:

EndpointCountsPer minute
POST /eventsEvents per project (a batch of 100 uses 100)600
POST /identifyRequests per project300
POST /feedbackRequests per project300
GET /decisionsRequests per project1,200
GET /decisionsRequests per end user120
POST /feedbackRequests per end user60
Data subject requestsRequests per project120

Rate limit headers#

Every response from a project-scoped endpoint carries the tightest limit that applied:

X-RateLimit-LimitThe limit for this window.
X-RateLimit-RemainingHow many are left.
X-RateLimit-ResetSeconds until the window resets.

Over the limit#

You get 429 rate_limited with a Retry-After header. Nothing in a refused request is stored, so resend it after that many seconds.

  • PageOverviewGet started
  • PageQuick startGet started
  • PageConceptsGet started
  • PageScript tag (tug.js)Install
  • PageReactInstall
  • PageNode and serverInstall
  • PageIdentity verificationGuides
  • PageCounting and holdoutsGuides
  • PagePostHogGuides
  • PageEnvironmentsGuides
  • PageData requestsGuides
  • PageOperator consoleGuides