---
title: "View card tokens"
method: GET
path: "/card/v3"
tags: ["Ecommerce"]
---

# View card tokens

`GET /card/v3`

Allows you to view all saved card tokens based on the given criteria. 

<!-- theme: info -->
> 📘 Note 
> 
> Nexio does not currently support returning terminal tokens from this endpoint. Instead, use the terminal's token with the [View card token details](https://docs.nexiopay.com/reference/viewcardtokendetails) endpoint.

Saved 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](https://docs.nexiopay.com/docs/sandbox-environments).
> 
> You can include any of the possible filters, or none of them, in your request. For example, `/card/v3/?expirationYear<2024&merchantId=000999` to return all records for the given merchantId and a card expiration year before 2024.

<div style="display:none;">

## Request parameters
- limit
- offset
- createdAt
- updatedAt
- merchantId
- merchantIds
- customerRef
- expirationMonth
- expirationYear
- accountUpdaterStatus
- shouldUpdateCard
- lastAccountUpdaterUpdate
- pauseAccountUpdater
- cardType
- firstSix
- lastFour
- token
- cardHolderName


## Response parameters
- limit
- offset
- hasMore
- rows.key
- rows.merchantId
- rows.customerRef
- rows.expirationMonth
- rows.expirationYear
- rows.accountUpdaterStatus
- rows.shouldUpdateCard
- rows.lastAccountUpdaterUpdate
- rows.pauseAccountUpdater
- rows.createdAt
- rows.updatedAt
- rows.cardType
- rows.firstSix
- rows.lastFour
- rows.token
- rows.cardHolderName
- random-nnnn

</div>

## Query parameters

- `limit` integer
- `offset` integer
- `createdAt` string
- `updatedAt` string
- `merchantId` string
- `merchantIds` string
- `customerRef` string
- `expirationMonth` string
- `expirationYear` string
- `cardType` string
- `cardHolderName` string
- `firstSix` string
- `lastFour` string
- `accountUpdaterStatus` string
- `lastAccountUpdaterUpdate` string
- `pauseAccountUpdater` string
- `shouldUpdateCard` string

## Response `200`

Success

- object
  - `limit` integer — The maximum number of records returned in a response (starting from the default or specified `offset` query parameter).
  - `offset` integer — The offset indicates how many card token records were skipped before beginning to return records in a response. If both `offset` and `limit` were used together, the offset records were skipped before starting to count the records to limit.
  - `hasMore` boolean — Will be `true` if there are more records after the current paged response. Use the `limit` and `offset` query parameters to display paged results.
  - `rows` object[]
    - `key` string — The Nexio unique key for the card token.
    - `token` Token — unresolved $ref
    - `customerRef` string — Customer identifier associated with the card/echeck token.
    - `merchantId` MerchantId — unresolved $ref
    - `cardType` CardType — unresolved $ref
    - `cardHolderName` CardHolderName — unresolved $ref
    - `firstSix` string — The first six digits of the card number.
    - `lastFour` string — The last four digits of the card number.
    - `expirationMonth` ExpirationMonth — unresolved $ref
    - `expirationYear` ExpirationYear — unresolved $ref
    - `createdAt` DateCreated — unresolved $ref
    - `updatedAt` DateLastModified — unresolved $ref
    - `shouldUpdateCard` ShouldUpdateCard — unresolved $ref
    - `accountUpdaterStatus` AccountUpdaterStatus — unresolved $ref
    - `lastAccountUpdaterUpdate` string — The most recent update to the card token from Account Updater. The value is one of the following: - `cardExpiration` - if the expiration date was changed - `cardNumber` - if the card number was changed - `accountClosed` - if the last update indicated that the account is closed - null - if no change has occurred yet
    - `pauseAccountUpdater` boolean — This parameter has been deprecated. For Nexio internal use only.
  - `random-nnnn` string — Used for sandbox/testing only. The parameter name includes a random set of numbers as part of the name and includes a random value in the response.\ \ This parameter and value have no meaning except to remind you to create a flexible integration with the Nexio API.

## Other responses

- `401` — Unauthorized. For help with this error and other error codes, see [Common errors](https://docs.nexiopay.com/docs/common-errors) in the Guides area.

---

[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-service-production.skmtc.workers.dev/v1/apis/nexiopay/payments-api-reference/revisions/b414b73979e5/schema)