List enrollments
Lists your company’s enrollments (see Enrollments: overview). Use it to follow the approval of requests, find a seller’s enrollments or check whether an identifier is already registered.
Endpoint
Section titled “Endpoint”https://api.rapidchargeback.com/api/v1/enrollmentsAuthentication
Section titled “Authentication”Authorization: Basic base64(client_id:client_secret)Query params
Section titled “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
Section titled “Following the approval”To know when a request was approved or rejected, query this list with updated_since every few minutes:
- Keep the highest
updated_atyou received. - On the next query, send that value minus 2 minutes as
updated_since. - Skip the (
id,updated_at) pair you already processed. - Read the pages up to
total_pages.
The 2-minute margin covers a change saved out of order or during your read.
Examples
Section titled “Examples”A seller’s enrollments
Section titled “A seller’s enrollments”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
Section titled “What changed since the last read”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
Section titled “Alerts waiting for approval”curl -G "https://api.rapidchargeback.com/api/v1/enrollments" \ --data-urlencode "product=alert" \ --data-urlencode "status=pending" \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Response
Section titled “Response”Success
Section titled “Success”{ "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.
Unknown parameter
Section titled “Unknown parameter”{ "error": { "code": "VALIDATION_ERROR", "message": "Unknown field: merchant", "params": { "field": "merchant" } }}- Only your company’s enrollments. The company comes from the credential.
- Blocked company receives
403 COMPANY_BLOCKED. - Auth, rate limit, error codes: see Authentication and Response codes.