---
updatedAt: 2025-09-18T21:26:12.000Z
agentTools:
  projectIndex: https://developers.payfit.io/llms.txt
---

# Rate limits

The number of call to the PayFit partner API is limited per client application (and not by valid `access_token`).

The default rate limit is **50 requests per second** for any READ requests and **20 requests per second** for write request.

If any of the limits configured is being reached, the API will return a 429 status code with the following JSON body:

```
{ "message": "API rate limit exceeded" }
```

Don't worry, we will send some additional headers back to you telling what are the limits allowed and how many requests are available:

```
X-RateLimit-Limit-Second:20
X-RateLimit-Remaining-Second: 4
```

We will also send headers telling the limits in the time frame and the number of requests remaining:

💡 We strongly suggest that you handle this error and add a "wait and retry" mechanism.