Settlement preferences
List an account's settlement destinations
List the typed destinations a UPA can settle to.
GET
List settlement destinations
Returns the destinations owned by the UPA. Filter by
type (crypto_wallet, bank_account, payment_rail_identifier) or status, and page with limit (up to 100) and cursor.
Connected wallets are synchronized as crypto destinations. Bank accounts and rail identifiers stay pending until provider verification and payout execution are operational. Pass a destination’s ID to Set an account’s settlement preference.
See Settlement destinations.Authorizations
HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.
Headers
Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.
Available options:
2026-09-09 Path Parameters
Canonical account id returned by the Accounts API.
Example:
"acct_123"
Query Parameters
Available options:
crypto_wallet, bank_account, payment_rail_identifier Available options:
pending_verification, active, restricted, disabled Required range:
1 <= x <= 100Opaque cursor returned as nextCursor by the previous page.