# How does API pagination work?

Most list endpoints take limit and offset. limit defaults to 50 and must be 1 to 200. offset defaults to 0 and must be 0 to 1,000,000. A value outside those ranges is refused with a 400 bad_request rather than quietly clamped, so you always know.

A list response is an object holding items, total, limit, and offset. Read total once and decide whether a second page is worth fetching.

Two endpoints differ. The coaching saved-reports list uses a cursor instead of an offset, with limit 1 to 100 defaulting to 25, and it refuses a half-supplied cursor pair. The older per-campaign Lead API defaults limit to 100 with a maximum of 500.

Read online: https://docs.closemagnet.com/articles/questions/how-does-api-pagination-work