To ensure fair usage and maintain a high-quality experience for all users, Payroo API enforces rate limits on incoming requests.

Request Type	Limit	Time Window
Authenticated Requests	100 requests	per minute
Bulk Operations (e.g., Pay Runs, Employee Imports)	10 requests	per 10 minutes

Important Notes:

• Rate limits are enforced at the organization level (not per user).

• Exceeding the limit will result in a 429 Too Many Requests response.

• The Retry-After header will be included in the 429 response, indicating when you can retry the request.

• Rate limits may vary for certain high-volume endpoints. Refer to the specific endpoint documentation for any exceptions.

Best Practices to Stay Within Limits:

• Implement exponential backoff when retrying failed requests.

• Use batch endpoints where available to minimize the number of API calls.

• Cache non-dynamic data where appropriate (e.g., static employee fields).