---
title: "Get Sub Wallet by ID"
method: GET
path: "/sub-wallets/{id}"
---

# Get Sub Wallet by ID

`GET /sub-wallets/{id}`

## Path parameters

- `id` string, required

## Query parameters

- `withVirtualAccount` boolean

## Request body

- object
  - `name` string, required — Wallet name. e.g. NGN Trading
  - `sequenceId` string, required — Unique wallet identifier / idempotency key
  - `currency` string, required — YC Supported fiat currency. e.g. NGN, KES

## Response `200`

OK

- object
  - `id` string
  - `partnerId` string
  - `sequenceId` string
  - `name` string
  - `metadata` object
  - `currency` string
  - `status` string
  - `createdAt` integer
  - `updatedAt` integer
  - `availableBalance` integer
  - `virtualAccount` object — Returned if `withVirtualAccount` is true
    - `id` string
    - `subwalletId` string
    - `provider` string
    - `currency` string
    - `accountNumber` string
    - `routingNumber` string
    - `swiftCode` string
    - `accountName` string
    - `bankName` string
    - `bankAddress` string
    - `status` string

## Other responses

- `201` — Created
- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/yellowcard/apis/yellow-cards-payment-api.md) · [All operations](https://skmtc.net/yellowcard/apis/yellow-cards-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yellowcard/yellow-cards-payment-api/versions/516d251059cc/schema)