---
title: "Retrieve a Network Token"
method: GET
path: "/payments/network-tokens/{network_token_id}"
tags: ["Payments", "Network Tokens"]
---

# Retrieve a Network Token

`GET /payments/network-tokens/{network_token_id}`

## Request

- Base URL: `https://api.evervault.com`
- URL: `https://api.evervault.com/payments/network-tokens/{network_token_id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/evervault/apis/evervault-api/docs/payments/network-tokens/:network_token_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a Network Token by its unique identifier.

## Path parameters

- `network_token_id` string, required

## Response `200`

Returns a Network Token object.

- NetworkToken
  - `id` string, required: A unique identifier representing a specific Network Token.
  - `number` string, required: The unique number of the Network Token.
  - `expiry` NetworkTokenExpiry, required: The network token expiry date.
    - `month` string, required: The network token expiry month, in MM format (e.g. 12 for December)
    - `year` string, required: The network token expiry year, in YY format (e.g. 29 for 2029)
  - `card` object, required: The details of the underlying encrypted card.
    - `lastFour` string, required: The last four digits of the card number.
    - `expiry` object, required: The expiry details of the card.
      - `month` string: The month of the card's expiry date, in MM format (e.g. 12 for December)
      - `year` string: The year of the card's expiry date, in YY format (e.g. 26 for 2026)
    - `brand` 'visa' | 'mastercard' | 'american-express', required: The card brand associated with the payment card.
  - `tokenRequestorIdentifier` string, required: The identifier of the Token Requestor (TRID) that requested the Network Token.
  - `tokenServiceProvider` 'mdes' | 'vts' | 'aets', required: The Token Service Provider (TSP) that issued the Network Token.
  - `paymentAccountReference` string: The unique identifier of the Payment Account associated with this Network Token.
  - `status` 'active' | 'inactive' | 'blocked' | 'provisioning' | 'suspended' | 'deleted' | 'expired', required: The status of the Network Token. Active means the token is valid and can be used for payments. Inactive means the token exists but is not currently active. Blocked and provisioning are reserved for future use. Suspended means the token is temporarily unusable but may be reactivated by the issuer or transition to deleted. Deleted is a terminal state where the token is permanently removed and a new credential must be obtained. Expired means the token has passed its expiration date and should not be used for transactions.
  - `merchant` string, required: The unique identifier of the Merchant associated with this Network Token.
  - `createdAt` integer, required: The exact time, in epoch milliseconds, when this Network Token was created.
  - `updatedAt` integer: The exact time, in epoch milliseconds, when this Network Token was last updated.

## Changes

- **2026-11-06** `8d0ca833fa04`: 1 warning, 5 info
  - added the new `american-express` enum value to the `card/brand` response property for the response status `200`
  - the response property `card/brand` became required for the status `200`
  - the response property `card/expiry` became required for the status `200`
  - the response property `card/lastFour` became required for the status `200`
  - …2 more
- **2026-04-17** `5e1eb58d42d5`: 5 warning
  - added the new `blocked` enum value to the `status` response property for the response status `200`
  - added the new `deleted` enum value to the `status` response property for the response status `200`
  - added the new `expired` enum value to the `status` response property for the response status `200`
  - added the new `provisioning` enum value to the `status` response property for the response status `200`
  - …1 more
- **2025-11-18** `30ea25af4354`: 3 info
  - api tag `Network Tokens` added
  - api tag `Payments` added
  - api tag `payments` removed

[Operation history](https://skmtc.dev/evervault/apis/evervault-api/changes/payments/network-tokens/:network_token_id/get.md)

---

[API](https://skmtc.dev/evervault/apis/evervault-api.md) - [All operations](https://skmtc.dev/evervault/apis/evervault-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evervault/apis/evervault-api/revisions/8d0ca833fa04?raw)