What is rate limiting?
Rate limiting is a mechanism used to control the number of requests a client can make to our API within a given timeframe. This helps ensure fair usage, protects the stability of the system, and prevents abuse (such as automated traffic floods). When a client exceeds the allowed request limit, the API will temporarily reject further requests and return an error response until the time window resets.What is the limit in the MijnKlantportaal API?
By default, each API key or access token is limited to 60 requests per minute. This limit is applied on a rolling basis, meaning once you reach the threshold, additional requests will be rejected until the next minute window begins. If you consistently need higher limits, please contact us to discuss your use case.How do I know how many requests I have left?
Every response of the API contains some headers with information about the rate limit:| Header | Description |
|---|---|
X-RateLimit-Limit | The limit that’s currently applied |
X-RateLimit-Remaining | Amount of calls left in the current minute |
retry-after | How many seconds you have to wait until you can call the API again. Only present when you hit the limit |
x-ratelimit-reset | The UNIX timestamp when the limit resets and you can make calls again. Only present when you hit the limit |
How do I know that I hit the limit?
Once you hit the limit, we return a fixed response:429 - Too Many Requests