List Payment Tokens

Lists all payment tokens created with the [`create_payment_token`](/api-reference/payment-tokens/create-payment-token) and [`create_payment_session`](/api-reference/payment-sessions/create-payment-session) endpoints. This endpoint returns a paginated view of all payment tokens associated with the API key used in the request header, sorted by their `created_at` date in descending order. Optional search fields are provided to aid in finding the token or tokens associated with a given user.

Authentication

x-truemed-api-keystring

Sales channel API key for merchant server-to-server authentication

Query parameters

pageintegerOptional
Optional field indicating which page to access. Defaults to 1.
page_sizeintegerOptional
Optional field indicating the number of records per page. Defaults to 30.
emailstringOptional
The email to search for. Partial matches supported, using 'includes' semantics.
namestringOptional
The name to search for. Partial matches supported, using 'includes' semantics.
card_expires_beforestringOptional

Filter payment tokens with cards expiring on or before this month (YYYY-MM format, e.g., ‘2024-06’)

lmn_expires_beforedateOptional

Filter payment tokens with lmns expiring on or before this month (YYYY-MM-DD) format, e.g., ‘2024-06-15’)

Response

Successful response
payment_tokenslist of objects

An array of payment_token objects.

paginationobject or null
A pagination object with information about the current page, page size, total count, and last page.

Errors