Rate limiting

Clients of this API can be rate limited at times if too many requests are sent in a short space of time. When rate limiting is applied an HTTP 429 response will be received. A client that receives this response should retry the request after a cool-down period. Other requests sent at a similar time should also be delayed as they will receive the same response.

When an HTTP 429 response is received the client can be confident that the request has not been processed by the Loaded system and it is safe to resend without concerns about data duplication.

Note that the rate limit high watermark is currently set to 600 requests per minute.

tip

We find it's the initial syncing of existing POS data into Loaded when clients can trip the rate limiter. Consider this when developing your integration - perhaps batching requests or throttling them in some way that is configurable.