**Last updated**: 28 August 2026 | [**Change log**](/products/tokens/changelog/)

# Query network tokens and provision cryptograms

Proceed to [network token inquiry](#network-token-inquiry) if you do not receive a network token, otherwise proceed to [provisioning a cryptogram](#provision-network-token-cryptograms).

## Network token inquiry

If you do not receive a `tokenNumber` , send a `GET` request to the `tokens:networkTokenLookup` action link returned in the response of your [create a network token request](/products/tokens/create-a-network-token#create-a-network-token-request).

## Network token inquiry request

`GET` `https://try.access.worldpay.com/tokens/network/E9026BB9-0FD3-47C9-A088-17A68BF07659`

Note
No request body is needed for this request.

### Response

The response status is `200 OK`. You receive links to your next available actions in your response. Please note, this API will always return token and card details associated with the token when it was created. These may become out of date over time.

```json 200 application/vnd.worldpay.tokens-v3.hal+json
{
  "tokenReference": "aa224320-425c-40b6-9781-2cb7df76b0c8",
  "tokenPaymentInstrument": {
    "status": "Active",
    "type": "card/networkToken",
    "tokenNumber": "4917610000000000",
    "expiryDate": {
      "month": 3,
      "year": 2030
    }
  },
  "paymentInstrument": {
    "type": "card/masked",
    "firstSix": "444433",
    "lastFour": "1111",
    "cardExpiryDate": {
      "month": 1,
      "year": 2030
    },
    "paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E"
  },
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/tokens/network"
    },
    "tokens:networkTokenLookup": {
      "href": "https://try.access.worldpay.com/tokens/network/aa224320-425c-40b6-9781-2cb7df76b0c8"
    },
    "curies": [
      {
        "href": "https://try.access.worldpay.com/rels/tokens/{rel}.json",
        "name": "tokens",
        "templated": true
      }
    ]
  }
}
```

## Provision network token cryptograms

Once you receive the `tokenNumber`, provision a cryptogram to take a [card on file payment](/products/payments). A cryptogram contains transaction specific information.

Note
Cryptograms are single use and valid for 24 hours.

To provision a network token cryptogram , `POST` your request to the `tokens:networkTokenCryptogram` action link.
`POST`  `https://try.access.worldpay.com/tokens/network/cryptograms`

#### Request

```shell curl
curl -i -X POST \
  https://try.access.worldpay.com/tokens/network/cryptograms \
  -H 'Content-Type: application/vnd.worldpay.tokens-v3.hal+json' \
  -d '{
    "tokenNumber": "4111111111111111"
  }'
```
 

| Parameter | Required | Description |
|  --- | --- | --- |
| `tokenNumber` | ✅ | 16 digit network token number, provisioned via card schemes. |


#### Response

```json 200 application/vnd.worldpay.tokens-v3.hal+json
{
  "cryptogramDetails": {
    "cryptogram": "AgAAAAAASFh+gDRt/rq8QOkAAAA=",
    "eci": "07"
  },
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/tokens/network/cryptograms"
    },
    "tokens:networkTokenLookup": {
      "href": "https://try.access.worldpay.com/tokens/network/{tokenReference}",
      "templated": true
    },
    "curies": [
      {
        "href": "https://try.access.worldpay.com/rels/tokens/{rel}.json",
        "name": "tokens",
        "templated": true
      }
    ]
  }
}
```

```json 404 application/vnd.worldpay.tokens-v3.hal+json
{
  "errorName": "resourceNotFound",
  "message": "Requested resource was not found"
}
```

## Delete network tokens

To delete a network token, send a `DELETE` request to the token resource with tokenNumber received in the `tokenPaymentInstrument` object in your create a network token [response](/products/tokens/create-a-network-token#responses).

You might want to delete tokens if a customer has closed their account with you, or if the customer no longer wants their card details kept on file.

### Request

`DELETE` `https://try.access.worldpay.com/tokens/network/4111111111111111`

Note
No request body is needed for this request. You can delete tokens of all types.

#### Response

The response status is `204 No Content`.

This action cannot be undone. Once we've received the request, the token is deleted.

br
**Next steps**

[Take a payment using cryptogram](/products/payments)