---
title: "Get card tokens"
method: GET
path: "/cards/{cardId}/tokens"
tags: ["Cards"]
---

# Get card tokens

`GET /cards/{cardId}/tokens`

Retrieves all payment card tokens for the given card

## Path parameters

- `cardId` string, required

## Query parameters

- `includeDeletedDevices` boolean

## Response `200`

Card tokens retrieved successfully

- CardGetCardTokensResponse
  - `size` integer, required — Number of elements in content
  - `content` CardCardToken[], required — List of response elements
    - `id` string, required — Card token ID
    - `expiry` string, date, required — Token expiry date (ISO 8601 format)
    - `type` 'BROWSER_ACCESSIBLE_WALLET' | 'CONTACTLESS_DEVICE_PAN' | 'CARD_ON_FILE_PAN' | 'REAL_PAN' | 'UNKNOWN' | 'VIRTUAL_PAN' | 'SECURE_ELEMENT' | 'CLOUD_BASED', required — Type of system the token is encoded onto
    - `wallet` 'APPLE' | 'GOOGLE' | 'MRCHTOKEN', required — Wallet the token belongs to
    - `status` 'APPROVED' | 'ACTIVE' | 'AWAITING_AUTHENTICATION' | 'AUTHENTICATION_FAILED' | 'AUTO_SUSPENDED' | 'SUSPENDED' | 'DEACTIVATED' | 'UNKNOWN', required — Card token status
    - `language` string, required — 2-digit ISO 639-1 language code
    - `devices` CardCardTokenDevice[]
      - `id` string, required — Device ID
      - `type` 'CLOTHING' | 'MEDIA_GAMING' | 'CARD' | 'DOMESTIC_APPLIANCE' | 'FOB' | 'MOBILE_TAG' | 'FASHION' | 'JEWELRY' | 'MOBILE_PHONE' | 'PERSONAL_COMPUTER' | 'WRISTBAND' | 'STICKER' | 'TABLET' | 'UNKNOWN' | 'VEHICLE' | 'WATCH' | 'MOBILE_PHONE_OR_TABLET', required — Device type
      - `ip` string, required — IPv4 address of the device. Either in hex format (i.e FFFFFFFF) or decimal format (i.e. 255.255.255.255)
      - `name` string, required — Device name, as given by the cardholder
      - `status` 'PENDING_PROVISIONING' | 'PROVISIONED' | 'DELETED' | 'UNKNOWN', required — Device status
      - `externalId` string, required — Device External Id
    - `maskedDpan` string — Masked DPAN (last 4 digits) to the associated token ID

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/revisions/cbd52524c8ef/schema)