Usage limits
Rate limits and caching for the Mindful API.
Mindful API rate limits
The following rate limits are in effect for individual IP addresses sending requests:
| Method/Endpoint | Requests allowed | Interval |
|---|---|---|
| POST — Create New Call Target | 1 | second |
| PUT — Update a Call Target | 1 | second |
GET — Retrieve historical aggregated callback offer metrics GET — Retrieve historical aggregated callback offer metrics by interval GET — Retrieve historical aggregated callback outcome metrics GET — Retrieve historical aggregated callback outcome metrics by interval | 10 | second |
| Other Mindful API endpoints | 100 | second |
When the rate limit has been exceeded, an error response of "429 - Too Many Requests" will be returned.
Mindful API caching
Endpoints cached for up to one second:
GET — Retrieve all Call Targets
GET — Retrieve Call Target details
GET — Retrieve callback offer decision attributes
Endpoints cached for up to 15 minutes:
GET — Retrieve historical aggregated callback offer metrics
GET — Retrieve historical aggregated callback offer metrics by interval
GET — Retrieve historical aggregated callback outcome metrics
GET — Retrieve historical aggregated callback outcome metrics by interval
Entries may be removed from the cache sooner than the expected timeframe if the cache overfills.
A 200 response code will be returned whether data was fetched from cache or queried in real time, and this cannot be changed by headers such as Cache-Control.
