Limits
The rate limits on provider keys — for each partner, for your own routes and overall — and the other bounds your integration works within.
Rate limits#
Every window is 15 minutes, and each of your keys has its own windows.
| Limit | Counted per | Applies to |
|---|---|---|
| 240 requests | Key and partner | Partner-scoped calls — catalogue, bookables and payments. Each partner has its own budget. |
| 240 requests | Key | Your own routes: /ping, /connections… and /webhooks…. |
| 12,000 requests | Key | Every call made with the key, for all partners together. |
| 20 claims | Key | POST /connections/claim. |
A call made with a valid provider key does not count against the per-IP limit of 300 requests per 15 minutes that applies to other Open Network traffic, so one server can act for many partners. A request with a missing or invalid key still counts against its IP address.
When you are limited#
A limited call answers 429 with a Retry-After header: wait that many seconds, then retry. An
over-limit claim carries the code connection_claim_rate_limited.
Responses carry the same RateLimit-* headers as partner calls — see
Rate limits. Several limits apply to each provider call, so back off on
any 429 by its Retry-After, rather than counting down one header.
Staying within the limits#
- Send a write when an item changes, not a full re-send on a timer.
- Spread one partner's bulk import over the window: 240 requests per 15 minutes is 16 a minute.
- Rely on webhooks —
connection.*,booking.*— instead of polling.
Other limits#
| What | Limit |
|---|---|
| Connection code | 15 minutes, single use. |
| Codes a partner can generate | 10 per 15 minutes. |
| Live keys | 5 per environment. |
| Webhook endpoints | 10. |
Webhook endpoint description | 200 characters. |
| Webhook URL | https, at most 2,048 characters. |
GET /connections page | 1 to 100 connections. |
GET /webhooks/deliveries page | 1 to 100 deliveries; 25 by default. |
| Request body | 1 MB. |
| Your webhook endpoint's answer | 10 seconds. |
| Webhook delivery attempts | 6, over about five minutes. |
| Automatic disabling of an endpoint | After 10 consecutive failed attempts. |
| Your inventory endpoint's answer | 1.5 seconds. |
The catalogue's field limits are in Create or replace an item.