Rate Limits & Throttling Data API

⚠️

The ROLLER Data API is read-only and not intended for real-time data use cases.

The Data API does not support querying individual records but instead provides paginated exports based on a record's modified date, ideal for daily batch exports. This enables both new and updated records to be retrieved in a single call for syncing with external systems like enterprise data warehouses or analytics platforms.

Rate & Call Limits

Rate Limit

• Each API credential set is restricted to 120 requests per 60 seconds,
  • With a 60 second cooling off period as a penalty if this is exceeded.

⚠️

Sharing the same credentials across multiple applications should be avoided as it may trigger 429 Too Many Requests errors.

Call Frequency Recommendations

• Requests to the Data API should not be more frequent than on a daily basis.
• Calls are recommended to be made out of business hours, for example anywhere between 01:00 - 07:00 (for the previous day)

For Get revenue entries, default page size is 100 and cannot be adjusted.

Monthly Call Limit

• This is governed by your ROLLER agreement or API access Add-On plan.
• Exceeding limits may lead to additional charges or suspension of access.
• API usage stats per endpoint are viewable via Venue Manager > Settings > Integrations > API Keys.

Bulk Exports

Rate Limit

• You are limited to one request every 6 hours, per exportType, per venue.
• There is no limit on date range.

⚠️

This rate limit is enforced and will result in a 429 Too Many Requests response if ignored.

API Usage

API usage is calculated depending on the size and date range of the request:

• 1 usage per 10,000 records, per calendar month.

Usage Examples

• A request from 2020/01/01 to 2020/04/01 spans 3 calendar months, and returns 1 record per month
  • This would count as 3 uses
• A request from 2020/01/28 to 2020/03/05 spans 3 calendar months, and returns 25,000 records per month
  • This would count as 9 uses
• A request from 2020/04/10 to 2020/05/10 spans 2 calendar months, and returns 600 and 0 records for APR, MAY respectively
  • This would count as 1 use