Get Counterparty External Wallet by ID
GET/v1/crossborder/counterparties/:id/wallets/:client_wallet_id
Retrieve detailed information about a specific counterparty external wallet, including its address, network, currency symbol, provider, status, and associated counterparty information. Requires both the counterparty ID and the client wallet ID.
Request
Path Parameters
Counterparty ID.
Client Wallet ID.
Header Parameters
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.
UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
Responses
- 200
- 400
- 401
- 404
Counterparty wallet returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Wallet ID.
User ID.
Counterparty ID.
Wallet name.
Wallet address.
Network.
Currency symbol.
Provider.
Possible values: [ACTIVE, INACTIVE, PENDING, BLOCKED]
Wallet status.
Wallet created date.
Wallet updated date.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"user_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"counterparty_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"name": "My Bitcoin Wallet",
"address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
"network": "ethereum",
"currency_symbol": "USD",
"provider": "MetaMask",
"status": "PENDING",
"created_at": "2026-03-26T14:02:59.420Z",
"updated_at": "2026-03-26T14:02:59.420Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
Counterparty wallet not found.