EVevervault
Payments
Network Tokens

Retrieve a Network Token

Retrieves a Network Token by its unique identifier.

get/payments/network-tokens/{network_token_id}

Request

Path parameters

network_token_idstring required

The unique identifier of the Network Token.

Response

Returns a Network Token object.

idstring required

A unique identifier representing a specific Network Token.

numberstring required

The unique number of the Network Token.

tokenRequestorIdentifierstring 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.

paymentAccountReferencestring

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.

merchantstring required

The unique identifier of the Merchant associated with this Network Token.

createdAtinteger required

The exact time, in epoch milliseconds, when this Network Token was created.

updatedAtinteger

The exact time, in epoch milliseconds, when this Network Token was last updated.

Example response

{
  "id": "network_token_eead1d640d7c",
  "number": "4498004918463434",
  "expiry": {
    "month": "13",
    "year": "25"
  },
  "card": {
    "lastFour": "4242",
    "expiry": {
      "month": "09",
      "year": "26"
    },
    "brand": "visa"
  },
  "paymentAccountReference": "512381d9f8e0629211e3949a08002",
  "tokenRequestorIdentifier": "40020248564",
  "tokenServiceProvider": "vts",
  "merchant": "merchant_ddsaJsda9d86",
  "status": "active",
  "createdAt": 1692972623233,
  "updatedAt": 1692972623768
}

Changes

No recorded changes to this operation across all 1 revision of this API.