---
title: "List Network Tokens"
method: GET
path: "/networkTokens"
tags: ["Network Tokenization"]
---

# List Network Tokens

`GET /networkTokens`

## Request

- Base URL: `https://eu-west-1.api.silverflow.com/v1`
- URL: `https://eu-west-1.api.silverflow.com/v1/networkTokens`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/silverflow/apis/silverflow-api/docs/networkTokens/get.ts> (a function with typed inputs; its response is checked against the schema)

This operation returns a (paged) list of all the stored network tokens for the authenticated Agent. 

Requires `networkTokens:List` permission.

## Query parameters

- `enrollmentKey` string: SCOF or VTS enrollment key
- `merchantKey` string: Uniquely identifies a merchant
- `status` 'requested' | 'active' | 'suspended' | 'failed' | 'archivePending'
- `offsetToken` string
- `limit` integer
- `sortOrder` 'asc' | 'desc'

## Response `200`

A (paged) list of network tokens

- TokensPage
  - `moreItems` boolean: Indicates whether there are more items available.
  - `offsetToken` string: An offset token that can be used to retrieve the next page of items.
  - `tokens` Token[]
    - `key` string, required: Uniquely identifies a network token managed by Silverflow.
    - `status` 'requested' | 'active' | 'suspended' | 'failed' | 'archivePending' | 'archived', required: The status of the network token.
    - `type` 'merchant', required: The type of network token.
    - `network` 'mastercard' | 'visa', required: The card network of the network token.
    - `provider` 'scof' | 'vts', required: The network token provider
    - `agentKey` string, required: Uniquely identifies an Agent
    - `merchantKey` string, required: Uniquely identifies a merchant
    - `enrollmentKey` string, required: SCOF or VTS enrollment key
    - `lastTokenRefresh` string, date-time: The date and time this network token was last refreshed
    - `error` TokenError: The error when the network token request failed
      - `code` string, required
      - `detail` string, required
    - `created` string, date-time, required: The date and time this object was created
    - `lastModified` string, date-time: The date and time this object was last modified
    - `version` integer, required: The version of this object

## Other responses

- `400`: The request was malformed. See the response body for details
- `401`: The supplied security credentials were missing or invalid
- `403`: The authenticated client is does not have the required permissions.
- `429`: The number of requests per unit of time has exceeded the configured maximum
- `500`: The server encountered an unexpected condition. This may or may not be a temporary situation.
- `503`: The server was unable to process the request. This is a temporary condition. Please retry the request.

---

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