Skip to main content
Kira limits how fast you can call the API. The limit is per account, set when your account is provisioned, and it applies across every endpoint rather than per endpoint.

What your account has

Two limits work together. One is a throughput limit, which is a rate with a burst allowance on top of it. The other is a quota: An account created today starts at 20 requests per second with a burst of 50, with a weekly quota of 50,000 requests in sandbox and 1,000,000 in production. Accounts set up earlier may have lower limits, and Kira can change them for an account, so your Kira contact has yours.

When you hit it

You get a 429.
Read the status code, not the message. A 429 is a rate limit. The body it comes with is a generic one, so an integration that branches on the message rather than the code will look for a problem that is not there.
Both limits produce the same status: the per-second one when you are going too fast right now, and the quota when you have used your allowance for the period. What separates them is that the first clears in a moment and the second does not.

Staying under it

Back off, do not retry immediately. Wait, then retry with the wait doubling each time. Retrying a 429 at once makes it worse and is the fastest way to stay limited. Do not poll. Almost everything worth knowing announces itself — see Webhooks. Polling is the most common reason an integration meets a rate limit at all, and it is avoidable. Spread scheduled work. A nightly job that fires everything at midnight uses your burst in a second and then queues behind your rate. Pace it. Ask before you need to. If your volume is growing, your limit is a configuration change rather than a rewrite. It is not self-serve, so ask ahead of the launch rather than during it.