> ## Documentation Index
> Fetch the complete documentation index at: https://developers.pcibooking.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Query & Retrieve Tokens

> Search stored tokens by card type, expiration, or customer. Retrieve card details or metadata without exposing sensitive data.

## Query Tokens

Search your stored tokens using the [Query Tokens](/api-reference/manage-tokens/query-tokens) endpoint. You can filter by:

* **Creator reference**. The reference you provided when the card was tokenized (e.g. a booking ID or customer ID). Exact match only.
* **Associated property**. A merchant or property ID linked to the token.

You must provide at least one of these filters. Results are ordered by creation date.

### Pagination

The query endpoint supports offset-based pagination:

| Parameter | Default | Description                                                               |
| --------- | ------- | ------------------------------------------------------------------------- |
| `num`     | 100     | Maximum number of tokens to return per request.                           |
| `from`    | 0       | Zero-based offset. Set to `100` to get the next page when `num` is `100`. |

To page through all results, increment `from` by `num` on each request until the response returns fewer items than `num`.

### What You Get Back

Each result includes token metadata only. No full card numbers are ever returned:

* Token URI (cardURI).
* Masked card number (first 6 and last 4 digits).
* Card type and brand.
* Expiration date.
* Cardholder name.
* Creation date.
* CVV status (whether CVV is stored and its retention end date).
* Associated merchants and properties.

## Retrieve Token Metadata

Fetch metadata for a specific token by its cardURI using the [Retrieve Token Metadata](/api-reference/manage-tokens/retrieve-token-metadata) endpoint. Returns the same masked data as the query endpoint, plus:

* Creator reference.
* Virtual card information (if applicable).
* 3DS authentication data (if stored).

This is the recommended way to look up a token's details. No sensitive card data is exposed.

## Next Steps

<CardGroup cols={2}>
  <Card title="Update Card Data" icon="book" href="/manage-tokens/update-card-data">
    Update expiry dates and other card details
  </Card>

  <Card title="Token Management Overview" icon="book" href="/manage-tokens/overview">
    All token management capabilities
  </Card>
</CardGroup>