Buvei
API ReferenceCards

Get Card

Retrieve card information (excluding sensitive PAN/CVV).

GET/open-api/v1/cards/{cardId}

Returns full card details with the PAN masked. For unmasked PAN, CVV, and expiry, use GET /cards/{cardId}/sensitive.

Path parameters

cardIdstringpathrequired

The card's unique identifier (e.g. cid_1234567890).

Card status values

StatusMeaning
CREATINGCard is being provisioned.
FAILEDProvisioning failed.
ENABLEActive.
DISABLEFrozen.
DELETINGDeletion in progress.
DELETEDDeleted; record retained for 90 days.
EXPIREDPast expiry date.

Response

cardIdstring
namestring
cardNumberstring
Masked PAN.
statusstring
See table above.
availableBalanceinteger
Current spendable balance in cents.
totalConsumptioninteger
Cumulative spend in cents.
cardBinIdstring
supportPinboolean
brandstring
cardholderNamestring
cardholderIdstring
Present when the card is bound to a KYC cardholder.
mobilePrefixstring
mobilestring
Mobile number without prefix.
emailstring
billingAddressobject
createdAtinteger
Epoch milliseconds.
updatedAtinteger
Epoch milliseconds.
Response
{
  "code": 0,
  "message": "SUCCESS",
  "data": {
    "cardId": "cid_1234567890",
    "name": "C78AB1234",
    "cardNumber": "555543******1234",
    "status": "ENABLE",
    "availableBalance": 8500,
    "totalConsumption": 1500,
    "cardBinId": "v_123456",
    "supportPin": true,
    "brand": "VISA",
    "cardholderName": "JOHN DOE",
    "cardholderId": "kyc_8f3a9c2b1d4e5f6a",
    "mobilePrefix": "+1",
    "mobile": "2025550123",
    "email": "[email protected]",
    "createdAt": 1640995200000,
    "updatedAt": 1640995300000,
    "billingAddress": {
      "line1": "123 Main Street",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "US"
    }
  }
}

On this page

Path parameters
Card status values
Response