# Listar comprobantes: GET /bill/receipts/list/

- Método y ruta: `GET /bill/receipts/list/`
- Scope: `invoices:read`
- Recurso: Facturación

## Qué hace

Requiere scope `invoices:read`.

## Parámetros

| Parámetro | Dónde | Requerido | Tipo | Descripción |
| --- | --- | --- | --- | --- |
| `page` | query | no | integer | Número de página (1-indexed). |
| `per_page` | query | no | integer | Resultados por página. |
| `search` | query | no | string | Término de búsqueda libre (aplica a los campos indexados de texto de la entidad). |
| `sort` | query | no | string | Campo de ordenamiento. Los campos válidos varían por entidad; uno inválido cae al default (`creation_date`). |
| `sort_dir` | query | no | string | Dirección de orden: 1 o asc = ascendente, -1 o desc = descendente (default -1). Otro valor responde 400. Valores: 1, -1, asc, desc. |
| `fields` | query | no | string | Lista de campos separados por coma para proyectar la respuesta (p. ej. `id,name,email`). Reduce el payload cuando solo se necesitan algunos campos. |
| `tipo_comprobante` | query | no | integer |  |
| `estado` | query | no | string |  |

## Errores

| Estado | Descripción | Código |
| --- | --- | --- |
| 401 | Falta autenticación o el token es inválido/expiró. | `UNAUTHORIZED` |
| 403 | El token no tiene el/los scope(s) requeridos, o el plan del tenant no habilita el módulo. | `FORBIDDEN` |
| 429 | Se superó el rate limit del endpoint o del tenant. Ver headers `X-RateLimit-*` y `Retry-After`. | `RATE_LIMITED` |

Referencia completa: https://yo-facturo.com/dev/referencia/