Returns every BIN attached to this client — including the disabled
and archived ones — with its upstream cardholder model
(providerCardHolderModel) and current isEnabled / isArchived
flags.
Unlike the account/user bin listings (which only surface bins that are attached AND enabled), this catalog also carries bins that are attached but no longer issuable, so an integrating service can keep its own BIN→model map in sync and retire bins decommissioned upstream. Bins never assigned to this client are not listed.
fees is the tariff your end users are charged on the BIN — not
the one you are charged. Issuing a card on a user account books two
fees: yours, off your master account, and this one, off the user's.
Quote this document to your customers and validate their balance
against it; the fees on GET /v1/accounts are your own cost and
will not match. It reflects your user tariff template where one is
configured, otherwise the BIN default; a tariff pinned to a single
user account overrides it and is not shown here.
To quote one end user exactly, read GET /v1/users/{id}: the
fees on each of account.bins are resolved the same way the issue
is charged, per-user tariff included. A BIN not yet attached to the
user is charged what this catalog shows.
Responses
| Status | Body | Description |
|---|---|---|
200 |
BinCatalogResponse |
The client's BIN catalog. |
Specification
This page is generated from the OpenAPI specification, which remains the authoritative machine-readable source.