Skip to main content
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

Authorization
string
header
required

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

Stableyard-Version
enum<string>

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

accountId
string
required

Canonical account id returned by the Accounts API.

Example:

"acct_123"

Query Parameters

type
enum<string>
Available options:
crypto_wallet,
bank_account,
payment_rail_identifier
status
enum<string>
Available options:
pending_verification,
active,
restricted,
disabled
limit
integer
default:20
Required range: 1 <= x <= 100
cursor
string

Opaque cursor returned as nextCursor by the previous page.

Response

Settlement destinations

accountId
string
required
destinations
object[]
required
nextCursor
string | null
required