Query & Retrieve Tokens

​

Query Tokens

Search your stored tokens using the 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: 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 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