# List enrollments

> Lists your company's enrollments, paginated, with filters by merchant, product, status and identifier, and a filter for what changed since a given time.

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

Lists your company's enrollments (see [Enrollments: overview](https://doc.rapidchargeback.com/en/canais/enrollments/visao-geral/)). Use it to follow the approval of requests, find a seller's enrollments or check whether an identifier is already registered.

## Endpoint

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

## Authentication

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

---

## Query params

All optional. A parameter outside this table is rejected with `422 VALIDATION_ERROR` (`Unknown field: <name>`).

| Param | Type | Default | Description |
|---|---|---|---|
| `page` | int (≥ 1) | `1` | Page |
| `per_page` | int (1–100) | `20` | Items per page |
| `merchant_id` | string (UUID) | - | Only this merchant's enrollments |
| `merchant_ref` | string (up to 100) | - | Only the enrollments of the merchant with this reference from your system. Without a merchant with the reference, the list comes back empty. The comparison ignores case and accents |
| `enrollment_type` | enum | - | `descriptor` or `bin_caid` |
| `product` | enum | - | `alert` or `prevention`. Alone: the enrollments where the product was requested |
| `status` | enum | - | `pending`, `active`, `deactivation_requested`, `inactive` or `rejected`. Without `product`: some product in that status. With `product`: that product only |
| `descriptor_value` | string (up to 255) | - | The exact value, case-insensitive |
| `bin` | string (6 to 10 digits) | - | Exact BIN |
| `caid` | string (up to 50) | - | Exact CAID |
| `updated_since` | ISO 8601 date and time with time zone | - | Only enrollments changed from that moment on (e.g. `2026-11-06T12:00:00Z`) |

With `merchant_id` and `merchant_ref` together, both must point to the same merchant; otherwise the list comes back empty.

Without `updated_since`, the order is by request (oldest first, then `id`). With `updated_since`, only what changed from that moment on, oldest first (`updated_at`, then `id`).

### Following the approval

To know when a request was approved or rejected, query this list with `updated_since` every few minutes:

1. Keep the highest `updated_at` you received.
2. On the next query, send that value **minus 2 minutes** as `updated_since`.
3. Skip the (`id`, `updated_at`) pair you already processed.
4. Read the pages up to `total_pages`.

The 2-minute margin covers a change saved out of order or during your read.

---

## Examples

### A seller's enrollments

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

### What changed since the last read

```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="
```

### Alerts waiting for approval

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

---

## Response

### Success

```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 }
}
```

The fields are in [Request enrollment](https://doc.rapidchargeback.com/en/canais/enrollments/pedir-enrollment/#created).

### Unknown parameter

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

---

## Notes

- **Only your company's enrollments.** The company comes from the credential.
- **Blocked company** receives `403 COMPANY_BLOCKED`.
- **Auth, rate limit, error codes:** see [Authentication](https://doc.rapidchargeback.com/en/referencia/autenticacao/) and [Response codes](https://doc.rapidchargeback.com/en/referencia/codigos-de-resposta/).
