v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

card

Get card details

Retrieves details for a specific card by its token.

get/v3/spend/profiles/{profileId}/cards/{cardToken}

Path parameters

profileIdinteger required

The ID of the profile that owns the card.

cardTokenstring uuid required

The unique token identifying the card.

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Response

Card details retrieved successfully.

tokenstring

Unique identifier for the card.

profileIdinteger

Profile ID that owns this card.

clientIdstring

Client ID of the partner that issued the card.

cardHolderNamestring

Name of the card holder.

expiryDatestring date-time

Date when the card will expire.

lastFourDigitsstring

Last 4 digits of the card number.

bankIdentificationNumberstring

Bank identification number (BIN) of the card.

phoneNumberstring

Phone number associated with the card.

unlockSpendingPermissions'WITH_PARTNER_API' | 'WITH_FIRST_CHIP_AND_PIN_TRANSACTION' | 'NONE'

Method with which physical card spending permissions can be unlocked. One of:

WITH_PARTNER_API - Unlock via Partner API
WITH_FIRST_CHIP_AND_PIN_TRANSACTION - Unlock with first chip and PIN transaction
NONE - Not applicable (for virtual cards)

creationTimestring date-time

Time when the card was created.

modificationTimestring date-time

Time when the card was last modified.

Example response

{
  "token": "ca0c8154-1e14-4464-a1ce-dcea7dc3de52",
  "profileId": 123456,
  "clientId": "wise_api_docs",
  "status": {
    "value": "ACTIVE"
  },
  "cardHolderName": "John Smith",
  "expiryDate": "2028-05-31T00:00:00Z",
  "lastFourDigits": "6320",
  "bankIdentificationNumber": "459661",
  "phoneNumber": "+441234567890",
  "cardProgram": {
    "name": "VISA_DEBIT_BUSINESS_UK_1",
    "scheme": "VISA",
    "defaultCurrency": "GBP",
    "cardType": "VIRTUAL"
  },
  "unlockSpendingPermissions": "WITH_PARTNER_API",
  "creationTime": "2022-05-31T01:43:24.596321434Z",
  "modificationTime": "2022-05-31T01:43:24.596321825Z"
}