---
title: "Get Network Token"
method: GET
path: "/network-tokens/{network_token_id}"
tags: ["Network Tokens"]
---

# Get Network Token

`GET /network-tokens/{network_token_id}`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/network-tokens/{network_token_id}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `string` scopes: `vault:network-tokens`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/network-tokens/:network_token_id/get.ts> (a function with typed inputs; its response is checked against the schema)

<span style="font-size: 12px; font-weight: 500; color: rgb(0, 0, 0); background-color: rgb(255, 176, 97); border-radius: 4px; padding: 2px 6px" >Beta</span><p></p> Given network token ID, this endpoint returns network token details: DPAN, expiry date, state, TRID and also card 
details like last four and expiry date.

## Path parameters

- `network_token_id` string, required

## Response `200`

Network Token details

- NetworkTokensRetrieveResponse
  - `card` NetworkTokensCard, required: The card details.
    - `last4` string, required: The last four digits of the card number.
    - `expiry_month` string, required: The card's expiration month.
    - `expiry_year` string, required: The card's expiration year.
  - `network_token` object, required: Network token details.
    - `id` string, required: The unique identifier for the network token.
    - `state` 'active' | 'suspended' | 'inactive' | 'declined' | 'requested', required: The token's status.
    - `number` string: The network token number. This field is only returned when the network token `status` is one of the following: - `active` - `suspended` - `inactive`
    - `expiry_month` string: The network token's expiration month. This field is only returned when the network token `status` is one of the following: - `active` - `suspended` - `inactive`
    - `expiry_year` string: The network token's expiration year. This field is only returned when the network token `status` is one of the following: - `active` - `suspended` - `inactive`
    - `type` 'vts' | 'mdes', required: The network token type.
    - `payment_account_reference` string: The unique reference assigned to the payment account. All payment tokens and underlying PANs associated with a payment account share the same `payment_account_reference`.
    - `created_on` string, date-time, required: The UTC date and time the network token was created.
    - `modified_on` string, date-time, required: The UTC date and time the network token was modified.
  - `token_requestor_id` string: The unique identifier for the token requestor.
  - `token_scheme_id` string: The scheme-specific identifier for the network token. For Visa, this is equivalent to the `vProvisionedTokenID`. For Mastercard, this is equivalent to the `tokenUniqueReference`.
  - `_links` NetworkTokensResponseLinks
    - `self` Link
      - `href` string, required: The link URL
    - `cryptogram` Link
      - `href` string, required: The link URL
    - `card-art` Link
      - `href` string, required: The link URL

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Network Token not found
- `500`: Internal Server Error
- `502`: Bad Gateway
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)