---
title: "View card token details"
method: GET
path: "/pay/v3/vault/card/{cardToken}"
tags: ["Ecommerce"]
---

# View card token details

`GET /pay/v3/vault/card/{cardToken}`

## Request

- Base URL: `https://api.nexiopaysandbox.com`
- URL: `https://api.nexiopaysandbox.com/pay/v3/vault/card/{cardToken}`
- Auth: HTTP basic

Allows you to view details of a specific card or terminal token. 

Card tokens can be used to process through any MID on your account. They are not restricted to a specific merchant account or currency.

<!-- theme: warning -->
> ⚠️ Try It
> 
> To use the Try It feature for this endpoint, you can use the credentials for your [Sandbox API user](doc:sandbox-environments).<br/><br/>You can also use the following test account. Copy the value and paste it into the appropriate space in the Try It section to the right.
> username: `docs@nexiopay.com`
> password: `JZdzoXpdDeH6VA`<br/><br/>Include a saved card token in the path parameter of the request. (Due to technical limitations, the **Try It** feature does not support the use of a terminal token.)

<div style="display:none;">

## Request parameters
- cardToken

## Response parameters
- accountUpdaterStatus
- card.expirationMonth
- card.expirationYear
- card.cardHolderName
- card.firstSix
- card.lastFour
- card.token
- card.cardType
- data
- data.customer
- data.customer.billToAddressOne
- data.customer.billToAddressTwo
- data.customer.billToCity
- data.customer.billToCountry
- data.customer.billToPhone
- data.customer.billToPostal
- data.customer.billToState
- data.customer.birthDate
- data.customer.createdAtDate
- data.customer.customerRef
- data.customer.email
- data.customer.firstName
- data.customer.invoice
- data.customer.lastName
- data.customer.phone
- data.customer.shipToAddressOne
- data.customer.shipToAddressTwo
- data.customer.shipToCity
- data.customer.shipToCountry
- data.customer.shipToPhone
- data.customer.shipToPostal
- data.customer.shipToState
- dateCreated
- dateLastModified
- merchantId
- shouldUpdateCard
- tokenex
- tokenex.cardType
- tokenex.firstSix
- tokenex.lastFour
- tokenex.token

</div>

## Path parameters

- `cardToken` string, required

## Response `200`

Success.

- object
  - `dateCreated` string: The date and time when the record of this card was created, formatted as an [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) date expressed in UTC.
  - `dateLastModified` string: The date and time at which the record of this card was last modified, formatted as an [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) date expressed in UTC.
  - `merchantId` MerchantId (unresolved $ref)
  - `card` object: Card information
    - `cardType` 'amex' | 'discover' | 'jcb' | 'mastercard' | 'visa': The card type. This parameter only gets returned if the token is a terminal token. However, not all connections for terminals return this value. **Note:** This is the card type used with a terminal and not the card type from a saved card token. See the `tokenex` object for the `cardType` for a saved card token.
    - `cardHolderName` string: The cardholder's name as it appears on the card. **Note:** For terminal-based tokens, not all connectors return this value.
    - `cardNumber` string: The card number, with all but the first six and the last four digits masked. This parameter only gets returned here if the token is a terminal token.
    - `firstSix` string: The first six digits of the card number. This parameter only gets returned here if the token is a terminal token. **Note:** This is the first six of a card used with a terminal and not from a saved card token. See the `tokenex` object for the `firstSix` for a saved card token.
    - `lastFour` string: The last four digits of the card number. This parameter only gets returned here if the token is a terminal token. **Note:** This is the last four of a card used with a terminal and not from a saved card token. See the `tokenex` object for the `lastFour` for a saved card token.
    - `expirationMonth` string: The two-digit month in which the card will expire.
    - `expirationYear` string: The two-digit year in which the card will expire.
    - `token` string: The terminal token for a card that is saved during the Retail payment process (see the [Process transaction from terminal](ref:processtransactionfromterminal) endpoint). The token always begins with the following string: `terminal:` This parameter only gets returned if the token is a terminal token. **Note:** This is the terminal token and not the token from a saved card. See the `tokenex` object for the token for a saved card.
  - `tokenex` object: The card token information. This object only gets returned if the token is a saved card token.
    - `cardType` 'amex' | 'discover' | 'jcb' | 'mastercard' | 'visa': The card type. For saved card tokens, the system updates this value in `tokenex.cardType`. For terminal tokens, the system updates this value in `card.cardType`.
    - `firstSix` string: The first six digits of the card number. This value is saved in the card token (in `tokenex.firstSix`).
    - `lastFour` string: The last four digits of the card number. This value is saved in the card token (in `tokenex.lastFour`).
    - `token` string: The TokenEx card token. This is the saved card token. Card tokens can be used to process through any MID on your account. They are not restricted to a specific merchant account or currency.
  - `data` object: Additional data attached to the card token
    - `customer` Customer (unresolved $ref)
  - `shouldUpdateCard` ShouldUpdateCard (unresolved $ref)
  - `accountUpdaterStatus` string: The card's account updater status with legacy providers. This parameter has been deprecated. For a list of possible values and meanings, see the account updater [card status](doc:checking-a-cards-enrollment-tag#card-status) table in Guides.
  - `random` RandomNnnn (unresolved $ref)

## Other responses

- `401`: Unauthorized. For help with this error and other error codes, see [Common errors](doc:common-errors) in the Guides area.

## Changes

- **2026-11-03** `d20a0473c611`: 1 info
  - added the optional property `error` to the response with the `401` status

[Operation history](https://skmtc.dev/nexiopay/apis/payments-api-reference/changes/pay/v3/vault/card/:cardToken/get.md)

---

[API](https://skmtc.dev/nexiopay/apis/payments-api-reference.md) - [All operations](https://skmtc.dev/nexiopay/apis/payments-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/nexiopay/apis/payments-api-reference/revisions/d20a0473c611?raw)