Beds24 · Rate Limits

Beds24 Rate Limits

Beds24 API V2 enforces a credit-based rate limit at the account level over a rolling 5-minute window. Each request consumes a number of credits (its request cost), and heavier requests cost more credits than lighter ones. The default allowance is 100 credits per 5-minute period. Tokens issued under the same account share the same credit pool; different accounts, including sub-accounts, have separate pools. Every response reports the current state via the x-five-min-limit-remaining, x-five-min-limit-resets-in, and x-request-cost headers. Beds24 also advises spacing calls a few seconds apart and keeping API usage to the minimum required for reasonable business use; the legacy v1 API warns that excessive usage within a 5-minute period can cause the account to be blocked without warning.

Beds24 Rate Limits is the machine-readable rate-limit profile for Beds24 on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 4 rate-limit definitions, measuring credits and requests.

The profile also includes 3 backoff/retry policies defined and response codes documented for throttled.

Tagged areas include Vacation Rental, Channel Manager, Hospitality, Rate Limiting, and Credits.

4 Limits Throttle: 429
Vacation RentalChannel ManagerHospitalityRate LimitingCreditsQuotas

Limits

Account Credit Limit account
credits
100 credits / 5 minutes (default)
Default allowance per rolling 5-minute window, shared across all tokens under the account. Reported by x-five-min-limit-remaining and reset by x-five-min-limit-resets-in.
Per-Request Cost request
credits
variable per endpoint
Each request deducts credits from the account pool; the amount is returned in the x-request-cost response header. Heavier reads/writes cost more.
Sub-Account Pools account
credits
separate per account
Sub-accounts and separate accounts each get their own independent credit pool.
Legacy v1 Usage account
requests
not published (guarded)
The legacy JSON/XML v1 API does not publish a numeric limit but warns that excessive usage within a 5-minute period may block the account without warning.

Policies

Space Out Calls
Beds24 recommends spacing API calls a few seconds apart and keeping usage to the minimum required for reasonable business use.
Cache Bulk Data
Retrieve availability and pricing in bulk (for example a year at a time via the inventory calendar) and cache it locally to reduce credit consumption.
Backoff on 429
On a 429 response, wait for x-five-min-limit-resets-in seconds before retrying and implement exponential backoff with jitter.

Sources