API restrictions and 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.
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.
| 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 |
