--- title: "API overview" slug: "api-overview" description: "ROLLER's REST API and Reporting API, how authentication and rate limits work, and how to create and scope API keys in Venue Manager." tags: ["Reference"] updated: 2026-09-29T02:34:08Z published: 2026-09-29T02:34:08Z canonical: "mysupport.roller.software/api-overview" --- > ## Documentation Index > Fetch the complete documentation index at: https://mysupport.roller.software/llms.txt > Use this file to discover all available pages before exploring further. # API overview This guide provides an overview of ROLLER's different APIs and best practices. See the [API changelog](https://docs.roller.app/docs/api/changelog) to keep up-to-date with updates to the ROLLER API. > [!CAUTION] > API access > > API access is an add-on feature to an existing ROLLER subscription. Contact your customer success manager or the [support team](/v1/docs/contact-roller-support) if you're interested in subscribing to this feature. > > [Learn more](https://www.roller.software/features/api-integrations/) ## APIs API documentation can be found in the ROLLER developer center at [https://docs.roller.app](https://docs.roller.app). ROLLER has two APIs as follows: - **Reporting API** The Reporting API provides venues with a mechanism to extract ROLLER data and syndicate that data to an external database, business intelligence or analytics platform. It does not provide any ability to write data to ROLLER. This API should not be used for real-time data use cases, as it does not allow you to query specific records, and returns paginated data for a time period. It is optimized for periodic export of records on an hourly or daily frequency. For more information, see the guide [Reporting API overview](/v1/docs/data-api) and [Reporting API](https://docs.roller.app/docs/api/reporting) in the ROLLER developer center. - **REST API** The REST API is a general-purpose API which supports live use cases and enables the creation of ROLLER bookings. For more information, see [REST API](https://docs.roller.app/docs/api/rest) in the ROLLER developer center. ## General concepts ### Authentication ROLLER APIs use an OAuth2 flow whereby the consuming app uses its client id and client secret from ROLLER to request an access token from the /token endpoint. It is this access token that is used in calls to API endpoints. The access token is short-lived. Its expiry is provided in the token response and may change from time to time. Therefore consumer apps should always reuse the current token until they receive a ***401 (Unauthorized)*** response from any endpoint at which time they should request a new token. **Do not request a new token for each API call.** This may result in a ***429 (Too many requests)*** response and result in the suspension of your API credentials/access. For more information regarding the authentication endpoint, go to [API authentication](https://docs.roller.app/docs/api/authentication) in the ROLLER developer center ### Scope The scope of a set of API credentials (client id and client secret) is limited to a single venue. If you have multiple ROLLER venues you must create separate sets of credentials for each venue. For more information regarding creating API credentials, go to [API access](https://docs.roller.app/docs/api/getting-api-access) in the ROLLER developer center. A set of credentials will enable the consumer app to access both the production and playground environment endpoints as per information regarding environments. ### Rate limiting Each set of API credentials are limited to one API call per second. We don't recommend sharing a set of API credentials between consumer apps, as this may result in a ***429 (Too many requests)*** response. ## Create API credentials in ROLLER After subscribing to API access with ROLLER, you can create API credentials to link ROLLER's public API with an external application. When you create a new API key, you define the scope of that key. This means you choose what it's allowed to do and choose the actions a key can perform and the type of data it can touch, so each key only has the access it needs. This makes it easier to share a key safely with a partner or agency, keep sensitive data like guest and financial information locked down and stay ahead of privacy requirements like GDPR and CCPA, without slowing down the integrations you rely on. > [!NOTE] > **Booking**, **Capacity** and **Payment** write endpoints are restricted and only available on request. To get access to these endpoints, contain your CSM or [ROLLER support](/v1/docs/contact-roller-support). To get started: 1. From Venue Manager, go to **Settings** > **Integrations** > **API Keys**. 2. Select **Create client key**. A pop-up window will be displayed. 3. Select to create **API Key** or **Gate Server Key** from the toggle options. 4. Enter a description in the **Client key name** field which describes the consumer app that these credentials will be allocated to (eg Data warehouse app). 5. Select **Create**. Then, define the API key scope: 1. From the API keys list, select the **options menu (three dots)** at the end of the row for the API key you wish to update. 2. Select **Update scope** from the dropdown. 3. Depending on what you want your API key to have access to, select either **No access**, **All unrestricted endpoints** or **Specific endpoints**. 4. If you select **Specific endpoints** for either (or both) the REST API and Reporting API, choose the actions and data types the key needs. 5. Select **Confirm**. [Scope API key endpoint access.](https://app.supademo.com/embed/cmum1lvkg0azrqmfhkv1csrsc?embed_v=2&utm_source=embed) Enter the **client ID** and **client secret ID** into the appropriate fields in the external application's account. If you're not sure where, contact the provider's support team. To learn more, see [Generate a ROLLER API key](https://docs.roller.app/docs/api/getting-api-access) in the ROLLER developer center. See the guide [Extend your capabilities with our integrations](/v1/docs/extend-your-capabilities-with-our-integrations) to find out more about the integrations we currently support and our [partner directory](https://www.roller.software/partners). ## Create API keys for multiple venues (HQ) If you're working from HQ and want to generate a key that works across **multiple connected venues**: 1. Select **API Key** as the key type. 2. Enter a **Client key name** to describe the integration or app. 3. Select the **Create keys for multiple venues** checkbox. 4. Use the **Select** **venues** drop-down to choose one or more venues connected to HQ that you would like to include. 5. Select **Create** to generate the keys. ![](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/13057642949903.png) ## Related - [Reporting API overview](/data-api.md) - [Manage API excess call usage](/manage-api-excess-call-usage.md) - [ROLLER API FAQs](/roller-api-faq.md) - [Extend your capabilities with our integrations](/extend-your-capabilities-with-our-integrations.md)