# Listar enrollments

> Lista los enrollments de tu empresa, paginados, con filtros por merchant, producto, estado e identificador, y el filtro de lo que cambió desde una fecha.

Página: https://doc.rapidchargeback.com/es/canais/enrollments/listar-enrollments/

Lista los enrollments de tu empresa (ver [Enrollments: visión general](https://doc.rapidchargeback.com/es/canais/enrollments/visao-geral/)). Úsala para seguir la aprobación de las solicitudes, encontrar los enrollments de un vendedor o revisar si un identificador ya está registrado.

## Endpoint

```
GET https://api.rapidchargeback.com/api/v1/enrollments
```

## Autenticación

```
Authorization: Basic base64(client_id:client_secret)
```

---

## Query params

Todos opcionales. Un parámetro fuera de esta tabla se rechaza con `422 VALIDATION_ERROR` (`Unknown field: <nombre>`).

| Param | Tipo | Default | Descripción |
|---|---|---|---|
| `page` | int (≥ 1) | `1` | Página |
| `per_page` | int (1–100) | `20` | Ítems por página |
| `merchant_id` | string (UUID) | - | Solo los enrollments de ese merchant |
| `merchant_ref` | string (hasta 100) | - | Solo los enrollments del merchant con esa referencia de tu sistema. Sin merchant con la referencia, la lista viene vacía. La comparación no distingue mayúsculas ni acentos |
| `enrollment_type` | enum | - | `descriptor` o `bin_caid` |
| `product` | enum | - | `alert` o `prevention`. Solo: los enrollments en los que se solicitó el producto |
| `status` | enum | - | `pending`, `active`, `deactivation_requested`, `inactive` o `rejected`. Sin `product`: algún producto en ese estado. Con `product`: solo ese producto |
| `descriptor_value` | string (hasta 255) | - | El valor exacto, sin distinguir mayúsculas |
| `bin` | string (6 a 10 dígitos) | - | BIN exacto |
| `caid` | string (hasta 50) | - | CAID exacto |
| `updated_since` | fecha y hora ISO 8601 con zona horaria | - | Solo los enrollments modificados a partir de ese instante (ej.: `2026-11-06T12:00:00Z`) |

Con `merchant_id` y `merchant_ref` juntos, los dos deben apuntar al mismo merchant; si no, la lista viene vacía.

Sin `updated_since`, el orden es el de solicitud (el más antiguo primero, después `id`). Con `updated_since`, solo lo que cambió a partir de ese instante, del más antiguo al más nuevo (`updated_at`, después `id`).

### Seguir la aprobación

Para saber cuándo una solicitud fue aprobada o rechazada, consulta esta lista con `updated_since` cada pocos minutos:

1. Guarda el mayor `updated_at` que recibiste.
2. En la consulta siguiente, envía ese valor **menos 2 minutos** como `updated_since`.
3. Ignora el par (`id`, `updated_at`) que ya procesaste.
4. Lee las páginas hasta `total_pages`.

El margen de 2 minutos cubre el cambio guardado fuera de orden o durante tu lectura.

---

## Ejemplos

### Los enrollments de un vendedor

```bash
curl -G "https://api.rapidchargeback.com/api/v1/enrollments" \
  --data-urlencode "merchant_ref=PB-1001" \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
```

### Lo que cambió desde la última lectura

```bash
curl -G "https://api.rapidchargeback.com/api/v1/enrollments" \
  --data-urlencode "updated_since=2026-11-07T14:58:00Z" \
  --data-urlencode "per_page=100" \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
```

### Alertas esperando aprobación

```bash
curl -G "https://api.rapidchargeback.com/api/v1/enrollments" \
  --data-urlencode "product=alert" \
  --data-urlencode "status=pending" \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
```

---

## Respuesta

### Éxito

```json
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-0000000000aa",
      "merchant_id": "00000000-0000-0000-0000-000000000001",
      "merchant_ref": "PB-1001",
      "enrollment_type": "descriptor",
      "descriptor_value": "loja exemplo",
      "descriptor_rule": "exact",
      "bin": null,
      "caid": null,
      "arn": null,
      "products": {
        "alert": { "status": "active", "rejection_reason": null, "approved_at": "2026-11-07T15:00:00.000Z" },
        "prevention": null
      },
      "created_at": "2026-11-06T12:00:00.000Z",
      "updated_at": "2026-11-07T15:00:00.000Z"
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 1, "total_pages": 1 }
}
```

Los campos están en [Solicitar enrollment](https://doc.rapidchargeback.com/es/canais/enrollments/pedir-enrollment/#creado).

### Parámetro desconocido

```json
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Unknown field: merchant",
    "params": { "field": "merchant" }
  }
}
```

---

## Notas

- **Solo los enrollments de tu empresa.** La empresa viene de la credencial.
- **Empresa bloqueada** recibe `403 COMPANY_BLOCKED`.
- **Auth, rate limit, códigos de error:** ver [Autenticación](https://doc.rapidchargeback.com/es/referencia/autenticacao/) y [Códigos de respuesta](https://doc.rapidchargeback.com/es/referencia/codigos-de-resposta/).
