v1

latestOpenAPI 3.1.02026-07-26460218.4 KB

Get Sub Wallet by ID

get/sub-wallets/{id}

Path parameters

idstring required

Query parameters

withVirtualAccountboolean

When true, includes virtual bank account data for the sub-wallet in the response

Request body

namestring required

Wallet name. e.g. NGN Trading

sequenceIdstring required

Unique wallet identifier / idempotency key

currencystring required

YC Supported fiat currency. e.g. NGN, KES

Response

idstring

partnerIdstring

sequenceIdstring

namestring

metadataobject

currencystring

statusstring

createdAtinteger

updatedAtinteger

availableBalanceinteger

Example response

{
  "id": "6fb07a60-a2c2-5eb6-bb4b-6a91b04962b1",
  "partnerId": "9b821520-52d4-4e91-990c-b2f5452cbc2d",
  "sequenceId": "james-uuid-test-3",
  "name": "NGN Primary",
  "currency": "NGN",
  "status": "active",
  "createdAt": 1768578971832,
  "updatedAt": 1768578971832,
  "virtualAccount": {
    "id": "d7fbe40a-6d50-4607-8648-9827a54947c3",
    "subwalletId": "6959f27c-9886-536b-a276-e1f4c2e632db",
    "provider": "erebor",
    "currency": "USD",
    "accountNumber": "1234567890",
    "routingNumber": "125108405",
    "swiftCode": "12345",
    "accountName": "Primary Account Number",
    "bankName": "Erebor Bank",
    "status": "PENDING"
  }
}