---
title: "Retrieve a token"
method: GET
path: "/v1/tokens/{ctoken}"
---

# Retrieve a token

`GET /v1/tokens/{ctoken}`

## Request

- Base URL: `https://token-sandbox.dev.clover.com`
- URL: `https://token-sandbox.dev.clover.com/v1/tokens/{ctoken}`
- Auth: none declared

Retrieve token for the provided unique ID

## Path parameters

- `ctoken` string, required

## Response `200`

Successful response

- object
  - `card` object: Card details, including metadata of the tokenized card.
    - `number` string: Card number.
    - `encrypted_pan` string: Encrypted card primary account number (PAN) provided by TransArmor.
    - `exp_month` string: Card expiration month in 2-digit format-(MM).
    - `exp_year` string: Card expiration year in 2- or 4- digit format-(YYYY).
    - `cvv` string: Card verification value.
    - `last4` string: Last 4 numbers of the primary account number.
    - `first6` string: First 6 numbers of the primary account number.
    - `country` string: 2-character country code.
    - `brand` 'VISA' | 'MC' | 'AMEX' | 'DISCOVER' | 'DINERS_CLUB' | 'JCB': Card brand.
    - `id` string: Unique identifier.
    - `object` string: Object type. Objects with the same type have the same value.
    - `name` string: Cardholder's full name.
    - `address_line1` string: Address line 1 (Street address/P.O. Box/Company name).
    - `address_line2` string: Address line 2 (Apartment/Suite/Unit/Building).
    - `address_city` string: City/District/Suburb/Town/Village.
    - `address_state` string: State/County/Province/Region.
    - `address_zip` string: ZIP or postal code.
    - `address_country` string: Billing address country, if provided.
    - `cvc_check` 'pass' | 'fail' | 'unavailable' | 'unchecked': Results of the card verification code (CVC) check when a card payment is submitted to a card network for authorization. The card issuer checks the CVC against the information on file for the cardholder.
  - `cloverToken` object
    - `id` string: Unique ID
    - `tokenValue` string: Public source token by Clover
    - `merchantUuid` string: Merchant UUID
    - `developerAppUuid` string: Developer UUID
    - `createdTime` integer
    - `lastAccessedTime` integer
  - `multipayToken` object
    - `id` string: Unique ID
    - `tokenValue` string: Private HSM encrypted token value provided by TransArmor
    - `tokenValueBackup` string: Private RSA encrypted token value provided by TransArmor
    - `taTokenType` string: TransArmor token type
    - `createdTime` integer
    - `modifiedTime` integer
  - `tokenMeta` object
    - `id` string: Unique ID
    - `cloverTokenId` integer: Meta ID of the token stored by Clover
    - `tokenStatus` 'NEW' | 'VERIFIED'
    - `tokenType` 'ONEOFF' | 'MULTIPAY' | 'RECURRING'
    - `tokenProvider` 'TASTM' | 'IPG' | 'MOCK'
    - `paymentInstrument` 'CARD'
    - `createdTime` integer
    - `modifiedTime` integer

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/clover/apis/card-tokenization-service-api.md) - [All operations](https://skmtc.dev/clover/apis/card-tokenization-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clover/apis/card-tokenization-service-api/revisions/2638d0447481?raw)