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

StatusBodyDescription
200 BinCatalogResponse

The client's BIN catalog.

Specification

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