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

# Paginación

> Navegue a través de grandes conjuntos de resultados

# Paginación

Los endpoints que devuelven listas de resultados lo hacen de forma paginada. Use los parámetros de consulta `page` y `limit` para controlar la respuesta.

## Parámetros

| Parámetro | Tipo    | Por defecto | Descripción                     |
| --------- | ------- | ----------- | ------------------------------- |
| `page`    | integer | `1`         | Número de página (inicia en 1)  |
| `limit`   | integer | `20`        | Elementos por página (máx: 100) |

## Ejemplo

```bash theme={null}
curl -X GET "https://api.nevatal.com/api/v1/patients?page=2&limit=10" 
  -H "Authorization: Bearer nvtl_su_clave_de_api"
```

## Formato de respuesta

Todas las respuestas paginadas incluyen un objeto `pagination`:

```json theme={null}
{
  "data": [...],
  "pagination": {
    "page": 2,
    "limit": 10,
    "total": 142,
    "totalPages": 15
  }
}
```

## Mejores prácticas

* Use tamaños de página razonables (10-50 elementos) para la mayoría de los casos de uso.
* Almacene en caché las respuestas cuando sea posible para reducir las llamadas a la API.
* Use el campo `total` para construir la interfaz de usuario de paginación o para detectar cuándo ha obtenido todos los resultados.