Rate Limits

How the WinWinKit API throttles excessive traffic and how to react when you hit a limit.

Calls to our REST API are rate limited to provide equitable access to the API for everyone and to prevent abuse. We are going to be evolving these limits as we gather more information, and encourage your feedback.

Handling rate limit errors

Once you exceed rate limits, the WinWinKit API returns a 429 Too Many Requests response with the standard error shape:

{
  "errors": [
    {
      "code": "TOO_MANY_REQUESTS",
      "status": 429,
      "message": "Too Many Requests",
      "source": null
    }
  ]
}

Retry the request after a short backoff. If you consistently hit the limit during normal usage, batch where you can and avoid tight polling — most user state can be read once and cached client-side.