Skip to main content
GET
List cards

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

Trio-Version
enum<string>
required

Version of the v2 contract the client is written against. Each breaking change publishes a new version.

Available options:
2026-10-19.v2
Trio-Target-Org-Id
string<uuid>

ID of another org to act on instead of the API key's own org. The key's org must have been granted access to it, and the request is refused with 403 FORBIDDEN otherwise. When that access or the API key is read-only, only GET and HEAD requests may carry it. When the target org requires mTLS, so does the request. Leave it out to act on the key's own org.

Query Parameters

entity_id
string<uuid>
required

Entity ID Unique identifier

card_last_digits
string

Card Last Four Digits

display_name
string

Card Display Name

holder_name
string

Card Holder Name

holder_tax_number
string

Card Holder Tax Number

before
string

Parameter used for pagination. It is a base64 encoded param used to access the previous page of results. It is provided alongside a metadata section if there is a previous page.

after
string

Parameter used for pagination. It's a base64 encoded param used to access the previous page of results. Provided along with the data in the metadata section if there is a previous page.

limit
integer

Parameter used for pagination.

Response

Cards

A page of cards. Read a card for its balance.

data
V2 card · object[]
required
metadata
V2 card list metadata · object
required

Pagination cursors

Example: