> ## Documentation Index > Fetch the complete documentation index at: https://catchbackcards.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Pagination > How the list endpoints page, the most each one returns, and how to know when you've reached the end. Seven endpoints return their results in pages. Six page by number, and [List orders](https://catchbackcards.mintlify.site/partner-api/endpoints/list-orders.md) pages by cursor. ## Numbered pages These take `page` (1-based) and `per_page`, and echo back the values they used. | Endpoint | Default `per_page` | Most per page | Most pages | Order | How you know there's more | | - | - | - | - | - | - | | [Search cards](https://catchbackcards.mintlify.site/partner-api/endpoints/search-cards.md) | 50 | 100 | 20 | `price` (your `sort`); at an equal price, user listings before shop stock, each by id | `has_more` | | [Your listings](https://catchbackcards.mintlify.site/partner-api/endpoints/get-listings.md) | 100 | 200 | no limit | newest first, then listing id | `total`, which is `null` on a page past the end, and `has_more` | | [Get vault](https://catchbackcards.mintlify.site/partner-api/endpoints/get-vault.md) | 100 | 200 | no limit | card id, ascending | `total`, which is `null` on a page past the end | | [List shipments](https://catchbackcards.mintlify.site/partner-api/endpoints/list-shipments.md) | 50 | 100 | 100,000 | newest first | `total`, which is `null` on a page past the end | | [Card catalog export](https://catchbackcards.mintlify.site/partner-api/endpoints/card-catalog.md) | 500 | 1000 | no limit | card id, ascending | `total`, which is `null` on a page past the end | | [Purchase report](https://catchbackcards.mintlify.site/partner-api/endpoints/purchase-report.md) | 500 | 1000 | no limit | `created_at`, then `user_id`, `source`, `pack_type` and `amount` | `total` | So Search cards reaches at most 20 pages of 100 (2,000 results), Your listings and Get vault return up to 200 a page, List shipments up to 100, and the catalog export and purchase report up to 1,000 rows a page. ## Cursor pages [List orders](https://catchbackcards.mintlify.site/partner-api/endpoints/list-orders.md) merges four kinds of order, newest first, so it pages by an opaque cursor instead of a page number: * `limit` sets the page size: 1–100, default 50. * Each page returns `has_more` and `next_cursor`. Send `next_cursor` back as `cursor`, unchanged, for the next page. On the last page `has_more` is `false` and `next_cursor` is `null`. * The cursor carries the first page's `since`, `until` and `type`, so later pages ignore those parameters. Orders placed while you page can't shift what you see, even with the default `until` of now. * A cursor that wasn't passed back unchanged is a `400`. The other endpoints aren't paginated. [List packs](https://catchbackcards.mintlify.site/partner-api/endpoints/list-packs.md) returns every pack you can buy, and [Get a pack's pool](https://catchbackcards.mintlify.site/partner-api/endpoints/get-pack-pool.md) every card or product a pull can produce, in one response. [List test accounts](https://catchbackcards.mintlify.site/partner-api/endpoints/list-test-accounts.md) returns the newest 100. [Price history](https://catchbackcards.mintlify.site/partner-api/endpoints/get-price-history.md) returns every point in its window, and [Card activity](https://catchbackcards.mintlify.site/partner-api/endpoints/get-card-activity.md) the newest sales and listings up to its `limit`. ## Out-of-range values Paging values are clamped, not rejected, except on [List shipments](https://catchbackcards.mintlify.site/partner-api/endpoints/list-shipments.md), where a value out of range is a `400`: * A `page` below 1, or one that isn't a number, is page 1. * A `per_page` or `limit` above the most per page is that maximum. Send a whole number from 1 up: anything else is replaced, by the default or by 1. * On Search cards, a `page` above 20 is page 20. Read `page` and `per_page` back from the response rather than assuming what you sent was used. Card activity's `limit` and the `days` on Price history and Card activity aren't paging values: out of range, they're a `400`. ## Reaching the end * **Get vault, Card catalog export and Purchase report** return `total`, the number of rows across all pages. Keep incrementing `page` until you've fetched `total` rows. A page past the end is an empty list, and on Get vault and Card catalog export its `total` is `null`, so keep the last number you read. **Your listings** returns `total` and `has_more`. * **Search cards** returns `has_more` instead. It is `true` when at least one more result follows the page, and always `false` on page 20, the last page you can ask for: a `page` above 20 returns page 20 again. To see further, narrow the price range: set `min_price` to the last result's price (`max_price` with `price_desc`) and start again from page 1, skipping the results at that price you already have. A search can also stop at its read ceiling, with `truncated: true`: see [How far a search reaches](https://catchbackcards.mintlify.site/partner-api/endpoints/search-cards.md#how-far-a-search-reaches). * **List orders** returns `has_more` and `next_cursor`: see [Cursor pages](#cursor-pages). ## Pages are snapshots Inventory changes between your requests ([why](https://catchbackcards.mintlify.site/partner-api/errors-and-limits.md#inventory-is-point-in-time)), so a card can move between pages, or drop out, while you page through Search cards, Your listings, Get vault or the catalog export. Ordering by id keeps a sync stable enough to diff against your copy, but don't treat one pass as an exact snapshot. The Purchase report is different: purchases are only ever added, so a window that has already closed pages consistently. Pin both `since` and `until` in the past for a report. List orders keeps its place by cursor, so new orders can't shift a page, though an order's `status` can still change between pages. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.