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

# Paginación

Por *defecto*, Fintoc pagina 30 elementos en cada respuesta de un endpoint de tipo List, como el endpoint para [List Movements](/es/reference/movements-api/movements/movements-list). La API también devuelve la información de paginación usando el [header `Link`](https://tools.ietf.org/html/rfc5988), siguiendo el [estándar RFC](https://tools.ietf.org/html/rfc8288). **Ojo**: el header `Link` **no tiene nada que ver** con los **Fintoc Links**. Es simplemente una desafortunada coincidencia de nombres 😕.

Para cada solicitud paginada, la API devuelve la información de paginación usando el header `Link`. Este header contiene una o más URLs que dirigen a diferentes páginas.

# Paginación v1

Los endpoints en el namespace `/v1`, como [List Payment Intents](/es/reference/payments-api/payment-intents/payment-intents-list), usan paginación por offset. El header `Link` en este namespace te permite navegar a la siguiente, anterior, primera y última página:

```text Link Header theme={null}
Link: <https://api.fintoc.com/v1/links?page=1>; rel="first",
  <https://api.fintoc.com/v1/links?page=2; rel="next"
```

Los posibles valores de `rel` son:

| Nombre  | Descripción                                          |
| :------ | :--------------------------------------------------- |
| `next`  | Link que lleva a la **siguiente página** del recurso |
| `last`  | Link que lleva a la **última página** del recurso    |
| `first` | Link que lleva a la **primera página** del recurso   |
| `prev`  | Link que lleva a la **página anterior** del recurso  |

# Paginación en V2

Los endpoints en el namespace `/v2`, como [List Transfers](/es/reference/transfers-api/transfers/transfers-list), usan paginación basada en cursor. En este namespace, el header `Link` solo permite navegar a la siguiente página de la lista:

```text Link Header theme={null}
Link: <https://api.fintoc.com/v2/transfers?starting_after=tr_12334567>; rel="next"
```

Los posibles valores de `rel` son:

| Nombre | Descripción                                          |
| :----- | :--------------------------------------------------- |
| `next` | Link que lleva a la **siguiente página** del recurso |

Si `Link` está vacío, significa que no hay más páginas.

# Paginación automática

Nuestro [SDK de Python](https://github.com/fintoc-com/fintoc-python) y [SDK de Node](https://github.com/fintoc-com/fintoc-node) soportan paginación automática. Esta función te permite iterar fácilmente a través de grandes listas de recursos sin tener que realizar manualmente las solicitudes para obtener las páginas siguientes:

```python python theme={null}
from fintoc import Fintoc

client = new Fintoc("your_api_key")

payment_intents = client.payment_intents.all()
for payment_intent in payment_intents:
    # Do something with the payment intent

```

```node Node theme={null}
import { Fintoc } from 'fintoc';

const client = new Fintoc('your_api_key');

const paymentIntents = await client.paymentIntents.list();
for await (const paymentIntent of paymentIntents) {
  // Do something with the paymentIntent
}
```

# Otras librerías

Si usas otros lenguajes o no quieres usar nuestro SDK, las siguientes librerías parsean el header `Link` para que no tengas que hacerlo tú:

| Lenguaje   | Librería                                                                            |
| :--------- | :---------------------------------------------------------------------------------- |
| Python     | [`requests`](https://requests.readthedocs.io/en/v3.0.0/user/advanced/#link-headers) |
| Ruby       | [`Nitlink`](https://github.com/alexpeattie/nitlink)                                 |
| JavaScript | [`parse-link-header`](https://github.com/thlorenz/parse-link-header)                |