---
title: "Get digital card details"
method: GET
path: "/issuing/digital-cards/{digitalCardId}"
tags: ["Digital cards"]
---

# Get digital card details

`GET /issuing/digital-cards/{digitalCardId}`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/issuing/digital-cards/{digitalCardId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `string` scopes: `issuing:card-management-read`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/issuing/digital-cards/:digitalCardId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the details for a digital card.

## Path parameters

- `digitalCardId` string, required: The digital card's unique identifier.

## Response `200`

Digital card retrieved successfully

- GetDigitalCardResponse
  - `id` string, required: The digital card's unique identifier.
  - `card_id` string, required: The card's unique identifier.
  - `client_id` string, required: The client's unique identifier.
  - `entity_id` string, required: The entity's unique identifier.
  - `last_four` string, required: The last four digits of the card number, also known as the PAN.
  - `status` 'active' | 'inactive' | 'deleted', required: The digital card's current status, which determines whether it can approve incoming authorizations: - `inactive`: the default state - authorizations will be declined until the card is activated - `active`: authorization requests can be approved - `deleted`: incoming authorization requests will be declined, permanently — the card cannot be reactivated from this state
  - `type` 'secure_element' | 'host_card_emulation' | 'card_on_file' | 'e_commerce' | 'qr_code': The type of digital card
  - `scheme_card_id` string: The ID that the card scheme’s token service provider (TSP) assigns to the PAN at the first tokenization.
  - `requestor` IssuingRequestor
    - `id` string: The requestor ID.
    - `name` string: The requestor name.
  - `device` IssuingDevice
    - `id` string: The device ID.
    - `type` 'host_card_emulation' | 'samsung_phone' | 'samsung_tablet' | 'samsung_watch' | 'samsung_tv' | 'iphone' | 'iwatch' | 'ipad' | 'mac_book' | 'android_phone' | 'android_tablet' | 'android_watch' | 'mobile_phone' | 'tablet' | 'watch' | 'mobile_phone_or_tablet' | 'bracelet' | 'unknown': The device type.
    - `manufacturer` string: The device manufacturer.
    - `brand` string: The device brand.
    - `model` string: The device model.
    - `os_version` string: The device operating system version.
    - `firmware_version` string: The device firmware version.
    - `phone_number` string: The device phone number.
    - `device_name` string: The device name.
    - `device_parent_id` string: The device parent ID.
    - `language` string: The device language.
    - `serial_number` string: The device serial number.
    - `time_zone` string: The device time zone.
    - `time_zone_setting` 'network_set' | 'consumer_set': The device time zone setting.
    - `sim_serial_number` string: The device SIM serial number.
    - `imei` string: The device International Mobile Equipment Identity (IMEI) number.
    - `network_operator` string: The device network operator.
    - `network_type` 'cellular' | 'wifi': The device network type.
  - `provisioned_on` string, UTC
  - `_links` DigitalCardLinks: The links related to the digital card.
    - `self` IssuingLink, required
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource

## Other responses

- `401`: Unauthorized
- `404`: Digital card not found
- `406`: Not Acceptable
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)