API ReferenceProducts & BINsBins

Get a card product's BIN

Get the full details of a BIN configured on this card product.

Required permissions: card_product:read.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

card_product_idstringRequired
bin_idstringRequired

Response

The BIN.
bin_idstring
Penny's unique identifier for this BIN.
versioninteger
A number that increases each time this BIN's details change. Use it to confirm you are looking at the latest information.
version_timedatetime
The date and time this BIN's details were last changed.
numberstring

The BIN digits (typically 6-8 digits) that identify this range of card numbers.

countrystring

The country cards under this BIN are issued in, as an ISO 3166-1 alpha-2 code.

schemeobject
The card network scheme used for cards issued under this BIN.
activeboolean
Whether this BIN is currently active for card issuance.
statusenum

This BIN’s current lifecycle status: ‘reserved’ (not yet in use), ‘active’, ‘deactivated’, or ‘deprecated’ (should not be used for new issuance).

Allowed values:

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error