Rate limits
Medallia Experience Cloud API call limits and restrictions
Most APIs are available on all Medallia Experience Cloud instances. Some APIs related to add-on features, such as the Speech API, are only available to customers who have purchased those features.
All instances of Medallia have an allowance of at least 60,000 API calls per 24-hour window. Certain APIs may have different baseline allowances, as described below. Allowances are based on your Experience Cloud subscription. If you require a higher daily call volume, contact your account representative.
When these limits are exceeded, the app or user may be throttled. API requests made by a throttled user or app will fail.
General API limits
These are the call limits for standard APIs.
| API | Requests per second | Requests per minute | Requests per day | Concurrent requests | Timeout (in seconds) |
|---|---|---|---|---|---|
| Query API | 70 | N/A | 975,000 | N/A | 90 |
| Speech API | N/A | 13,000 | 325,000 | 1,000 | 180 |
| Users API | 70 | N/A | 10,000 | N/A | 180 |
| Roles API | 70 | N/A | 10,000 | N/A | 180 |
| Import API: Import on concurrent processing mode | 1 | N/A | 1,950,000 | 5 | 600 |
| Import API: Import on non-concurrent processing mode | 10 | N/A | 1,950,000 | N/A | 600 |
| Feed File API: Results | 10 | N/A | 100,000 | N/A | 600 |
| Feed File API: Detailed results | 10 | N/A | 10,000 | N/A | 600 |
| Introspection API: All import endpoints | 10 | N/A | 10,000 | N/A | 600 |
| Introspection API: Specific import endpoint | 10 | N/A | 10,000 | N/A | 600 |
API-specific limits
These APIs have limits specific limits are:
Query API calls have a cost. Requests are subject to cost limits and are throttled once the 3,000,000 cost-units-per-query limit is reached.
Note: We limit the number of API calls per company to prevent unintended bugs in API client code or malicious code from taking down production systems. If you need higher limits, contact your Medallia representative to make the request.Important: Do not use Query API in front-end implementations where data is requested upon website load, for example, requesting NPS score to display on the brand site. For this and similar use cases, we recommend using a back-end integration to store the desired value and only update periodically.Import API (also known as Web Feeds) for concurrent feeds the data payload size limit is 100 MB, for non-concurrent feeds it is 1.5 GB.
Feed file API detailed results show up to the first 5,000 input records per result status for an import request. Examples of result status include records successfully created, updated, or discarded.
Speech API bulk uploads can handle up to 1,000 records per request. Additionally, there is a limit to the number of API calls an app can make within a given time period:
Up to 13,000 requests per minute
Up to 325,000 requests per 24-hour period
The timeout for a request is 180 seconds. The API Gateway discards any request that takes longer than that. However, the processing may take longer than 180 seconds. Consider verifying in reports to confirm the files have been processed before sending another request.
| Activity | Response |
|---|---|
| Simultaneously make 10 API calls/sec to the Users API and 10 API calls/sec to the Roles API on your production instance. | 200 OK |
| Simultaneously make 10 API calls/sec to the Users API on your production instance and 10 API calls/sec to the Users API on your sandbox. | 200 OK |
| Make 15 calls/sec to the Roles API on your production instance. | 200 OK for the first 10 calls, then 429 "Too Many Requests" for the last 5. |
GovCloud
Medallia APIs are available on GovCloud instances and have the same rate-limiting functionality as other medallia instances and data centers.
API HTTP response headers
Experience Cloud APIs returns HTTP headers to track rate limits. For more details see IETF draft-polli-ratelimit-headers.
| Parameter | Description | Sample values |
|---|---|---|
| X-RateLimit-Limit | Request quota associated with the client in the current time window (in seconds). | 10, 10;w=1, 100;w=86400 (Limit of 10 per call; 10 per second; and 100 per day) |
| X-RateLimit-Remaining | Remaining quota units associated with the client during the current time window. | 60 |
| X-RateLimit-Reset | Time remaining in the current window, specified in seconds, until the quota resets. | 10 |
