> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Paginación

> Paginación por desplazamiento, límites de tamaño de página y la forma de la respuesta de conexión.

Las operaciones de listado en toda la API se paginan con entradas de desplazamiento y devuelven objetos de estilo conexión. Hay dos regímenes de tamaño de página según la superficie.

## Forma de la solicitud

Pasa una entrada de desplazamiento en el argumento `paginate` de la operación:

| Entrada                                                             | Usado por                                                       | `limit` máximo                            | Campos            |
| ------------------------------------------------------------------- | --------------------------------------------------------------- | ----------------------------------------- | ----------------- |
| [`OffsetInput`](/api-reference/types/offset-input)                  | Listados estándar (`getTransactions`, `getUserCashBalances`, …) | **20**                                    | `limit`, `offset` |
| [`BulkPaginationInput`](/api-reference/types/bulk-pagination-input) | Listados de la API bulk                                         | **100** (también el valor predeterminado) | `limit`, `offset` |

```graphql theme={null}
query {
  getTransactions(
    filter: { }
    paginate: { limit: 20, offset: 0 }
  ) {
    transactions { transactionId amount createdAt }
    totalCount
    hasNextPage
  }
}
```

## Forma de la respuesta

Las consultas paginadas devuelven un objeto de conexión con los elementos más metadatos de paginación — por ejemplo [`TransactionConnection`](/api-reference/types/transaction-connection):

* la lista de elementos (p. ej., `transactions`)
* `totalCount` — total de elementos que coinciden con el filtro
* `hasNextPage` — si hay más resultados disponibles

Otros tipos de conexión siguen el mismo patrón: [`UserCashBalanceConnection`](/api-reference/types/user-cash-balance-connection), [`DeclinedTransactionConnection`](/api-reference/types/declined-transaction-connection), y [`PlaidBankTransactionPage`](/api-reference/types/plaid-bank-transaction-page).

## Recorrer un conjunto completo de resultados

Incrementa `offset` por `limit` mientras `hasNextPage` sea `true`:

1. Solicita `{ limit: 20, offset: 0 }`.
2. Si `hasNextPage` es `true`, solicita `{ limit: 20, offset: 20 }`, luego `40`, y así sucesivamente.
3. Detente cuando `hasNextPage` sea `false`.

<Note>
  Los resultados pueden desplazarse entre páginas si se crean nuevos registros mientras paginas — los listados de transacciones se ordenan de más reciente a más antiguo. Para exportaciones grandes, filtra por un rango de fechas fijo para que el conjunto subyacente sea estable mientras lo recorres.
</Note>