limit too large API Origin: Application & API OSI layer 7 · Application Last updated 13 Oct 2026

API Error: limit must be less than or equal to 100 (page size exceeds maximum)

You asked for more items per page than the endpoint allows.

Exact message you may see limit must be less than or equal toper_page must bepage size exceedsmaxResults exceedsmaximum page size
Seen on: REST API

Meaning

List endpoints cap page size (limit, per_page, pageSize, maxResults) — commonly 100, sometimes 50 or 1000. Some APIs silently clamp the value; stricter ones reject it with 400 and a message like “limit must be less than or equal to 100”.

To fetch everything, page through results instead of raising the limit.

Common causes

  • Requested page size above the documented maximum
  • Using a page size valid in another API version
  • limit/offset confused (offset sent as limit)

⚡ Quick fix

  1. Use the documented maximum or less
  2. Loop with cursor/page parameters to get all records
  3. Check parameter names (limit vs per_page)

Detailed fix by platform

REST API

  1. curl 'https://api.example.com/v1/orders?limit=100&starting_after=ord_123'

How to diagnose

  1. Limit — Value sent vs documented max
  2. Parameter — Correct name for this API?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Application & API. Errors that are often confused with or caused by this one (click to open):

additionalProperties — API Error: Request failed schema validation (must NOT have additional properties / Additional properties are not allowed) (API)additionalPropertiesinvalid_cursor — API Error: Invalid pagination cursor (invalid_cursor / cursor expired) (API)invalid_cursorinvalid_date — API Error: Invalid date format — expected ISO 8601 (YYYY-MM-DDTHH:mm:ssZ) (API)invalid_dateinvalid_id — API Error: Invalid ID format (not a valid UUID / malformed identifier) (API)invalid_idinvalid_request — OAuth 2.0 Error: invalid_request (missing or invalid parameter) (Authentication)invalid_requestinvalid_type — API Error: Invalid type — expected integer, received string (API)invalid_typeinvalid_value — API Error: Invalid parameter value — must be one of the allowed values / out of range (API)invalid_valueparameter_missing — API Error: Missing required parameter (parameter_missing / "x" is required) (API)parameter_missinglimit too…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.