Rate Limiting
Learn about rate limits for the Calry API.
Overview​
There are following types of rate limits to consider when using the Calry API:
- PMS Rate Limits.
- Calry Rate Limits.
PMS Rate Limits​
It is the rate limit set by the Source System (PMS) that you are working with. You need to consider the rate limit of the Source System when you are doing a realtime or passthrough request to a Source System. Calry API will return a rate limit error with the HTTP status code 429 - Too Many Requests when the request rate limit for a PMS Linked Account is reached.
When possible, we return the Source System's rate limit in the response headers.
Source System Rate Limits​
The rate limits for Source Systems are not standardized and can vary. We recommend checking the documentation for the specific Source System you are working with to understand their rate limits.
| Source System | Rate Limit | Reference |
|---|---|---|
| Hostaway | 15 requests per 10 second | Hostaway API Rate Limits |
| Guesty | 15 request per second, 120 request per minute, 5000 requests per hour | Guesty API Rate Limits |
| Hostfully | 10000 requests per hour | Hostfully API Rate Limits |
| Hostify | 20 requests per second | N/A |
| Ownerrez | 300 request per 5 minute | Ownerrez API Rate Limits |
| Lodgify | 600 requests per minute | Lodgify API Rate Limits |
| Beds24 | 100 credits per 5 minute, each request is average 1.5 credits | Beds24 API Rate Limits |
| Smoobu | 1000 requests per minute | Smoobu API Rate Limits |
| Hospitable | Not Listed | Hospitable API Docs |
| Uplisting | 4 requests per second, 100 requests per minute, 15 requests per minute per property | Uplisting API Rate Limits |
| FantasticStay | 20 requests per second | N/A |
| BookingSync | 1000 requests per hour | BookingSync API Rate Limits |
Calry Rate Limits​
API requests to Calry's Unified API are rate limited to 100 requests per minute per linked account (as identified by the integrationAccountId attached to the request). If you exceed this limit, you will receive a 429 Too Many Requests response.
Key points to note:
- Please do not poll the API. If you need to check for time-sensitive updates, webhooks are the absolute best option.
- Every time a sync request is executed with your Vacation Rental integration, or often following a successful write request, our data cache is updated. Typically, and customizable per customer and integration, this sync request happens every 12 hours. Polling the Calry API more often than this schedule won't yield new data, as it only updates in line with the syncing frequency.