Skip to content
English
Go to clouddepot.com
  • There are no suggestions because the search field is empty.

Understanding Xero API Limits with Cloud Depot

To ensure the Xero platform remains stable and performant for millions of users, Xero applies several layers of "API Limits" (limits on how many requests for data can be made). This article explains what those limits are, how Cloud Depot monitors them, and what the numbers in your logs mean.

What are Xero API Limits?

Unlike other platforms that have a single "pool" of requests, Xero uses a three-tier system to protect both individual customer data and their global infrastructure. Every time Cloud Depot syncs data, we must navigate these three distinct limits.

  • 1. The Tenant Minute Limit: Typically 60 requests per minute per organization. This prevents any single app from "flooding" a specific customer's data.

  • 2. The Tenant Daily Limit: Typically 5,000 requests per day per organization. This is a generous allowance for a single company's daily syncing needs.

  • 3. The Global App Limit: Typically 10,000 requests per minute for the entire Cloud Depot application. Because Cloud Depot services hundreds of customers, we monitor this closely to ensure one large sync doesn't impact our other users.

What happens if I go over a limit?

If any of these three limits are reached, Xero will issue a "429 Too Many Requests" error.

  • Minute limits usually clear up in less than 60 seconds.

  • Daily limits reset at midnight UTC

How Cloud Depot monitors your limits

We check your current usage levels every time we connect to Xero. This helps our support team (and you) understand if a sync is running slowly due to Xero's built-in "speed limits."

You will see a line in your Cloud Depot logs that looks like this:

Connect to Xero successful? Yes -> (59-4963-9968)

How to read the Log Message

The code in the brackets is a real-time "fuel gauge" for your Xero connection. Here is how to translate it:

(59 - 4963 - 9968)

  1. 59 (Minute Remaining): You have 59 requests left for this customer in the current minute. (Max: 60)

  2. 4963 (Day Remaining): You have 4,963 requests left for this customer for the rest of the day. (Max: 5,000)

  3. 9968 (Global App Remaining): Cloud Depot has 9,968 requests left in the current minute across our entire user base. (Max: 10,000)

In this example:

"The connection is healthy. The customer has used very little of their minute/daily allowance, and the global Cloud Depot platform has plenty of capacity."

Frequently Asked Questions

Why is my "Day" limit resetting at midday? Xero operates on UTC time. For users in New Zealand/Australia, the 24-hour "Day" limit resets during your workday (typically 12:00 PM NZST), rather than at local midnight.

Can I increase these limits? The Tenant limits (60/min and 5,000/day) are set by Xero and generally cannot be increased for individual organizations. Cloud Depot uses advanced batching logic to ensure we get the most out of every single request we make.