Skip to main content
GET
List wallets
Returns a page of wallets accessible to the caller. Supports filtering, ordering, and cursor-based pagination — see Pagination and Filtering. Filterable fields: id (string), status (enum), name (string), createdAt (timestamp). Orderable fields: createdAt.
For interactive UIs, use page_size=25 and pass nextPageToken back as page_token. For batch jobs, use page_size=100 (the maximum).

Authorizations

X-Access-Key
string
header
required

Opaque credential identifier provisioned during onboarding. See the Integration Guide for the request-signing protocol.

X-Access-Timestamp
string
header
required

Unix epoch timestamp in UTC milliseconds. See the Integration Guide for skew tolerance.

X-Access-Request-Id
string
header
required

Unique identifier per request (UUID v4 recommended). The (accessKey, requestId) tuple must be unique within the replay window defined by the Integration Guide.

X-Access-Signature
string
header
required

Base64-encoded ECDSA signature of the canonical request, computed with the private key paired to X-Access-Key. See the Integration Guide for canonicalization rules and reference implementations.

Query Parameters

filter
string

SFS-1 filter expression. See the SFS-1 specification for syntax. Allowed fields are listed per endpoint.

Maximum string length: 1024
order_by
string

Result ordering. See List Query Parameters for syntax. Allowed fields are listed per endpoint.

page_size
integer
default:100

Maximum items per page. Values above 1000 are silently truncated to 1000; negative or non-integer values return INVALID_PAGE_SIZE.

Required range: 1 <= x <= 1000
page_token
string

Opaque pagination token returned as nextPageToken by a previous list response. Tokens are bound to the original query context and may expire; treat as opaque.

Response

A page of wallets.

A single page of wallets with an opaque continuation token.

items
object[]
required

The wallets in this page, in the requested order.

nextPageToken
string | null
required

Opaque token for the next page; null when the result set is exhausted. Pass back as page_token to retrieve the next page.

Example:

"spct1.eyJ2IjoxLCJleHAiOjE3MzY1NTM2MDB9.aBcDeFgHiJkLmNoPqRsTuVwXyZ"