Get a card product's BIN range | The Penny Inc

{
  "bin_range_id": "bin_range_01937b28-f048-77de-8ef4-f0487deef42d",
  "version": 1,
  "version_time": "2024-01-15T10:30:00Z",
  "bin_id": "bin_01937000-0592-7190-87e7-05921907e7c5",
  "active": true,
  "status": "reserved",
  "currency": "USD",
  "capabilities": {
    "contactless_payments": true,
    "ecommerce_enabled": true,
    "international": {
      "card_present_enabled": true,
      "card_not_present_enabled": true,
      "cross_border_authorization_enabled": true
    },
    "supported_form_factors": [
      "virtual"
    ],
    "supported_usage_types": [
      "single_use"
    ]
  }
}

Get the full details of a single BIN range configured for a BIN 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

bin_range_idstringRequired

Response

The BIN range.

bin_range_idstring

Penny's unique identifier for this BIN range.

versioninteger

A number that increases each time this range's details change. Use it to confirm you are looking at the latest information.

version_timedatetime

The date and time this range's details were last changed.

bin_idstring

The BIN this range belongs to.

activeboolean

Whether this BIN range is currently active for card issuance.

statusenum

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

Allowed values:

currencyenum

The currency cards issued from this range are denominated in.

Allowed values:

capabilitiesobject

The payment capabilities available to cards issued from this range.

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