---
title: "List Cards for a User"
method: GET
path: "/v2.01/{ClientId}/users/{UserId}/cards"
tags: ["Cards"]
---

# List Cards for a User

`GET /v2.01/{ClientId}/users/{UserId}/cards`

List Cards for a User

## Path parameters

- `ClientId` string, required
- `UserId` string, required

## Query parameters

- `Active` boolean

## Headers

- `Authorization` string, required

## Response `200`

Success

- ListCardsForAFingerprintResponse
  - `Array (Cards)` ListCardsForAFingerprintResponseArrayCardsItems[] — The list of the cards created by the platform.
    - `Card` ListCardsForAFingerprintResponseArrayCardsItemsCard — The card object created by the platform.
      - `ExpirationDate` string — The expiration date of the card.
      - `Alias` string — The card number, partially obfuscated.
      - `CardType` string — **Returned values:** `CB_VISA_MASTERCARD`, `AMEX`, `MAESTRO`, `BCMC` **Default value:** `CB_VISA_MASTERCARD` The type of the card. If not supplied, the default value will be taken into account.
      - `CardProvider` string — **Allowed values:** `CB`, `VISA`, `MASTERCARD`, `AMEX`, `MAESTRO`, `BCMC`, `JCB`, `DISCOVER` The provider of the card.
      - `Country` string — The country of the card (which is the same as the country of the issuer).
      - `BankCode` string — The name of the card issuing bank.
      - `Active` boolean — Whether the card is active or not. Setting this parameter to `false` is irreversible and should be done once the pay-in is successful.
      - `Currency` string — **Returned values:** The three-letter <a href="/api-reference/overview/data-formats" target="_blank">ISO 4217 code</a> (EUR, GBP, etc.) of a <a href="/guides/currencies" target="_blank">supported currency</a> (depends on feature, contract, and activation settings). The currency of the card.
      - `Validity` string — **Returned values:** `UNKNOWN`, `VALID`, `INVALID` Whether the card is valid or not. - `UNKNOWN` – No payment or card validation has been processed, so the validity of the card remains unknown. - `VALID` – The first payment or card validation using the card was processed successfully within 24 hours of the initial card registration. - `INVALID` – The first payment or card validation using the card was attempted and failed, or the status of the corresponding card registration was `CREATED` for more than 24 hours. Once a card is set to `INVALID`, it cannot be set back to `VALID`. A new card registration will be necessary to make a payment.
      - `UserId` string — The unique identifier of the user the card belongs to.
      - `Id` string — The unique identifier of the Card object.
      - `Tag` string — Custom data added to this object. In the case of the Card object, the tag value is inherited from the Card Registration object and is not editable.
      - `CreationDate` integer — Unix timestamp (UTC) of the date and time the object was created.
      - `Fingerprint` string — The unique representation of the card number. This string can be used to track the card behavior while keeping the card information confidential.

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/fafbd0c69654/schema)