[{"data":1,"prerenderedAt":74},["ShallowReactive",2],{"doc:\u002Fdocs\u002Frate-limits":3},{"page":4,"toc":69,"updated":73},{"path":5,"title":6,"seoTitle":7,"description":8,"blocks":9},"\u002Fdocs\u002Frate-limits","Rate limits","Rate Limits for Identification","How identification is rate limited per organization, what a 429 looks like, and how the SDKs and your code should respond.",[10,13,18,30,32,35,49,52,59,65],{"type":11,"text":12},"p","Identify requests are rate limited per organization, across all of its keys and environments. Other endpoints are not rate limited.",{"type":14,"level":15,"text":16,"id":17},"heading",2,"Limits","limits",{"type":19,"columns":20,"rows":23},"table",[21,22],"","Default",[24,27],[25,26],"Sustained rate","1,000 identify requests per second",[28,29],"Burst","Up to 2,000 requests at once, refilling at the sustained rate",{"type":11,"text":31},"Development and staging traffic counts towards the same limit. If you need a higher limit, email [support@fingerly.io](mailto:support@fingerly.io).",{"type":14,"level":15,"text":33,"id":34},"Headers","headers",{"type":19,"columns":36,"rows":39},[37,38],"Header","Meaning",[40,43,46],[41,42],"`RateLimit-Limit`","Your organization's limit, per second.",[44,45],"`RateLimit-Remaining`","What remained when the request was admitted.",[47,48],"`Retry-After`","On `429`, seconds to wait.",{"type":14,"level":15,"text":50,"id":51},"When you exceed the limit","when-you-exceed-the-limit",{"type":53,"samples":54},"code",[55],{"label":56,"lang":57,"code":58},"429 Too Many Requests","json","{\n  \"error\": {\n    \"code\": \"rate_limited\",\n    \"message\": \"this organisation is sending faster than its rate limit allows\",\n    \"status\": 429\n  },\n  \"request_id\": \"01a0a84c-0f11-7a3e-9c2d-4b5e6f708192\"\n}",{"type":60,"items":61},"list",[62,63,64],"A refused request is not charged, and its `Idempotency-Key` is released so the retry is processed normally.","Each refusal sends an [`identification.refused`](\u002Freference\u002Fwebhooks\u002Fidentification-refused) webhook with the reason `rate_limited`.","The client SDKs retry `429` with jittered backoff.",{"type":66,"tone":67,"text":68},"callout","tip","Identify at meaningful moments rather than on every page view, and use the framework SDKs, which share one identification per page.",[70,71,72],{"id":17,"text":16,"level":15},{"id":34,"text":33,"level":15},{"id":51,"text":50,"level":15},"2026-09-17T08:28:36.000Z",1789667797515]