List the BIN catalog

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

Specification

This page is generated from the OpenAPI specification, which remains the authoritative machine-readable source.