Returns how many more cards the given cardholder can be issued on the given BIN. A cardholder may hold a fixed number of live cards at a time (3 unless the BIN says otherwise), so the caller must pin a specific `cardholderId`. Closing a card frees its slot, so `remaining` goes back up. Issuance is rejected once the cardholder is at its limit — register another cardholder to issue more. `hasLimit` is `false` when the BIN carries no per-cardholder limit; counts are zero and the cardholder should be treated as effectively unlimited.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
bin |
path | string |
yes | BIN code (e.g. `5449`, `4938`). |
cardholderId |
query | string (uuid) |
yes | Cardholder UUID, as returned when the cardholder was created. It must be registered for this BIN — otherwise the request is rejected. |
Responses
| Status | Body | Description |
|---|---|---|
200 |
BinCapacityResponse |
Capacity retrieved. |
400 |
Error |
Cardholder belongs to a different BIN's cardTypeId. |
404 |
Error |
BIN or cardholder not found. |
Specification
This page is generated from the OpenAPI specification, which remains the authoritative machine-readable source.