# 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.

## Query parameters:

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

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

## Header parameters:

  - `X-External-Correlation-Id` (string)
    Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. [Learn more](/guides/developer/headers/correlation-id).

## 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