> For the complete documentation index, see [llms.txt](https://docs.tnid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tnid.com/pagination.md).

# Pagination

How TNID list queries page: plain lists with limit, cursor-paginated twins with paginationInfo and nextCursor, and page-number lists for 10DLC.

TNID has three list shapes. Pick by name.

## Plain lists: `limit`

Queries such as `b2bConnections`, `spamReports`, `companies` and `users` take a `limit` and return a plain array. They are fine for small result sets and for the examples in this guide. There is no way to fetch the next batch.

## Cursor lists: `paginated…` queries

Every list that can grow has a cursor-paginated twin whose name starts with `paginated`, for example `paginatedB2bConnections`, `paginatedSpamReports`, `paginatedReceivedC2cConnectionRequests`, `paginatedUserGroups`, `paginatedClientSecrets` and `paginatedSentimentAnalysisResults`. Documents, forms, AI tasks and group members are cursor-paginated by default.

They take `limit` and `cursor` and return `paginationInfo` plus `records`:

```graphql
query ($limit: Int, $cursor: String) {
  paginatedB2bConnections(limit: $limit, cursor: $cursor) {
    paginationInfo {
      limit
      nextCursor
    }
    records {
      id
      type
      connectedCompany {
        id
        legalName
      }
    }
  }
}
```

First call with `{"limit": 50}`. Each response carries `paginationInfo.nextCursor`; pass it back as `cursor` to get the next page. When `nextCursor` is `null` you have everything. The default `limit` is 20.

```python
cursor = None
while True:
    page = client.execute(query, {"limit": 50, "cursor": cursor})["paginatedB2bConnections"]
    for record in page["records"]:
        handle(record)
    cursor = page["paginationInfo"]["nextCursor"]
    if cursor is None:
        break
```

Cursors are opaque strings. Do not store them across sessions or build them by hand; restart from the first page instead.

## Page-number lists: 10DLC

`tenDlcBrands` and `tenDlcCampaigns` use `page` and `pageSize` and return `page`, `totalRecords` and `records`. Increment `page` until `page * pageSize >= totalRecords`. See [10DLC Brands](/10dlc/brands.md).

## Finding the paginated variant

The [API Reference](https://docs.tnid.com/api-reference/) lists each plain query next to its paginated twin, and the [Queries](https://docs.tnid.com/api-reference/003_definitions/queries) definition page shows every argument.