v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

card

List cards for a profile

Returns a paginated list of cards that belong to a specific profile.

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

Path parameters

profileIdinteger required

The ID of the profile to retrieve cards for.

Query parameters

pageSizeinteger

The maximum number of cards to return per page. Must be between 10 and 100.

pageNumberinteger

The page number to retrieve. Must be greater than or equal to 1.

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

List of cards retrieved successfully.

totalCountinteger

The total number of cards for this profile.

Example response

{
  "cards": [
    {
      "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"
    }
  ],
  "totalCount": 1
}