Getting started

Rate limits

You can make 60 requests per minute per organization.

You can make 60 requests per minute per organization. When you go over the limit, the API answers with 429 Too Many Requests until the window resets.

Checking your rate limit

Every response carries headers with the current state of your limit:

Header	Description
`X-RateLimit-Limit`	The maximum number of requests per minute.
`X-RateLimit-Remaining`	The number of requests left in the current window.

A 429 response additionally carries:

Header	Description
`Retry-After`	The number of seconds to wait before making a new request.
`X-RateLimit-Reset`	The time at which the window resets, in UTC epoch seconds.

{
    "status": 429,
    "error": "Too many requests",
    "retry_after": 23
}

Staying within the limit

Wait for Retry-After seconds after a 429 before retrying, instead of retrying right away.
Use the list endpoints to fetch many records at once instead of fetching them one by one.
Cache data that rarely changes, such as your products and Mollie profiles.