limit too large 🔌 API

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.

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 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.