# List cards for a profile

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

Endpoint: GET /v3/spend/profiles/{profileId}/cards
Security: UserToken

## Path parameters:

  - `profileId` (integer, required)
    The ID of the profile to retrieve cards for.
    Example: 123456

## Query parameters:

  - `pageSize` (integer)
    The maximum number of cards to return per page. Must be between 10 and 100.
    Example: 10

  - `pageNumber` (integer)
    The page number to retrieve. Must be greater than or equal to 1.
    Example: 1

## Response 200 fields (application/json):

  - `cards` (array)
    Collection of cards for this profile.

  - `cards.token` (string)
    Unique identifier for the card.
    Example: "ca0c8154-1e14-4464-a1ce-dcea7dc3de52"

  - `cards.profileId` (integer)
    Profile ID that owns this card.
    Example: 123456

  - `cards.clientId` (string)
    Client ID of the partner that issued the card.
    Example: "wise_api_docs"

  - `cards.status` (object)
    Current status of the card.

  - `cards.status.value` (string)
    Status value. One of:
- ACTIVE - Card is active and can be used
- INACTIVE - Card is inactive and all transactions will be declined
- BLOCKED - Card is blocked and cannot be reversed back to any state
- FROZEN - Card is temporarily blocked
- PARTNER_SUSPENDED - Card is suspended by Wise temporarily (do not display to end customers)
- EXPIRED - Card is expired
- PURGED - Cardholder data (e.g. PAN, PIN) has been purged after the retention period (555 days after the card's expiry date)
    Enum: "ACTIVE", "INACTIVE", "BLOCKED", "FROZEN", "PARTNER_SUSPENDED", "EXPIRED", "PURGED"

  - `cards.cardHolderName` (string)
    Name of the card holder.
    Example: "John Smith"

  - `cards.expiryDate` (string)
    Date when the card will expire.
    Example: "2028-05-31T00:00:00Z"

  - `cards.lastFourDigits` (string)
    Last 4 digits of the card number.
    Example: "6320"

  - `cards.bankIdentificationNumber` (string)
    Bank identification number (BIN) of the card.
    Example: "459661"

  - `cards.phoneNumber` (string)
    Phone number associated with the card.
    Example: "+441234567890"

  - `cards.cardProgram` (object)
    Card program details.

  - `cards.cardProgram.name` (string)
    Name of the card program.
    Example: "VISA_DEBIT_BUSINESS_UK_1"

  - `cards.cardProgram.scheme` (string)
    Card network scheme.
    Enum: "VISA", "MASTERCARD"

  - `cards.cardProgram.defaultCurrency` (string)
    Default currency of the card.
    Example: "GBP"

  - `cards.cardProgram.cardType` (string)
    Type of the card. E.g. PHYSICAL or VIRTUAL.
    Example: "VIRTUAL"

  - `cards.unlockSpendingPermissions` (string)
    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)
    Enum: "WITH_PARTNER_API", "WITH_FIRST_CHIP_AND_PIN_TRANSACTION", "NONE"

  - `cards.creationTime` (string)
    Time when the card was created.
    Example: "2022-05-31T01:43:24.596321434Z"

  - `cards.modificationTime` (string)
    Time when the card was last modified.
    Example: "2022-05-31T01:43:24.596321825Z"

  - `totalCount` (integer)
    The total number of cards for this profile.
    Example: 1