Lightspeed Commerce · Rate Limits

Lightspeed Rate Limits

Every Lightspeed product line rate-limits differently, and two of them scale the limit with how much hardware the retailer runs. X-Series uses a 5-minute window sized at 300 x registers + 50; R-Series uses a leaky bucket whose size and drip rate grow per register, with per-request costs that vary by query parameter and nested relation. Both publish runtime headers, which is what an agent actually needs.

Lightspeed Rate Limits is the rate-limit profile for Lightspeed Commerce on the APIs.io network — every limit transcribed verbatim from the provider’s own documentation on 2026-08-27.

It captures 6 rate-limit definitions, including X-Series API requests, per retailer per application — 300 x + 50; *X-Series API requests, per retailer for all users* — 300 x + 50; *X-Series token endpoint* — rate limited independently of [the rest of the API].

Limit state is signalled in the x_series, x_series_token_endpoint, and r_series response headers, and an exhausted limit returns HTTP 429.

The profile also includes response codes documented for throttled.

Tagged areas include Commerce, Point-of-Sale, Retail, Restaurant, and Inventory.

6 Limits Exhausted: HTTP 429 x_seriesx_series_token_endpointr_series
Transcribed from the provider's documentation on 2026-08-27 — x-series-api.lightspeedhq.com/docs/rate_limiting, x-serie....
View Source
CommercePoint-of-SaleRetailRestaurantInventoryLoyaltyPaymentsE-CommerceOmnichannelCanada

Limits

X-Series API requests, per retailer per application per-application-per-retailer
300 x + 50
requests · 5 minutes
350
350 is the value for a single-register store, which is Lightspeed's own worked example. The limit grows with register count, so a retailer's API headroom is a function of the hardware they bought.
X-Series API requests, per retailer for all users per-retailer-all-users
300 x + 50
requests · 5 minutes
350
A separate bucket from the application bucket, deliberately, so an integration cannot rate-limit in-store staff mid-transaction and vice versa.
X-Series token endpoint per-application
rate limited independently of [the rest of the API]
https://{domain_prefix}.retail.lightspeed.app/api/1.0/token
requests
Rate limited independently of the rest of the API, and the limit is discoverable only at runtime: Lightspeed's documentation shows example headers (limit 10) but states explicitly that "all of these values are subject to change", so no numeric limit is recorded here. X-RateLimit-Reset is a Unix epoch second. Lightspeed's guidance is to use an access token until it expires (86400s) rather than re-minting it, which avoids this limit entirely.
R-Series leaky bucket, base per-account
Each connection has a base bucket size of 90
requests · per second drip
90
90-request bucket draining at 1 request per second.
R-Series leaky bucket, per additional register per-account
increased by 10 for each additional register beyond the first
requests · per second drip
10
Each register beyond the first adds 10 to the bucket and 0.5 drips/second. Lightspeed's worked example: 3 registers gives a 110-request bucket at 2 drips/second.
R-Series burst limiter per-accountburst
Lightspeed enforces a secondary burst rate limit to prevent sudden traffic spikes
requests · 1 second
A secondary limiter on top of the leaky bucket. Lightspeed documents the window (1 second) but not the threshold, so no number is recorded. Exceeding it returns 429 with the message "burst rate limit exceeded"; wait at least one second before retrying. Current usage is readable at runtime via X-LS-Api-Burst-Level.

Sources

Work with this as data

Every rate limit here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for rate limits

4 MCP tools reach this
  • find_rate_limitsBrowse and filter every rate limit in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This rate limit 
curl "https://apis.io/api/v1/rate-limits/lightspeed-rate-limits"
All rate limits 
curl "https://apis.io/api/v1/rate-limits?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.