> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tabsglobal.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Virtual Account

> Retrieve your assigned Nigerian virtual bank account details for incoming NIP transfers.

Retrieves the merchant assigned Nigerian virtual bank account details for receiving fiat NGN deposits.

### Scopes required

`wallets:read` or `*`

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer API secret key formatted as `Bearer sk_live_...` or `Bearer sk_test_...`.
</ParamField>

### Response

<ResponseField name="accountNumber" type="string">
  The 10-digit NUBAN virtual account number.
</ResponseField>

<ResponseField name="accountName" type="string">
  The legal beneficiary title assigned to this virtual account.
</ResponseField>

<ResponseField name="bankName" type="string">
  The partner financial institution holding the NUBAN.
</ResponseField>

<ResponseField name="bankCode" type="string">
  3-digit CBN bank code.
</ResponseField>

<ResponseField name="currency" type="string">
  Currency of inbound settlement (`NGN`).
</ResponseField>

<ResponseField name="status" type="string">
  Account status (`ACTIVE`, `SUSPENDED`).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tabsglobal.co/v1/wallets/virtual-account" \
    -H "Authorization: Bearer sk_live_..."
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.tabsglobal.co/v1/wallets/virtual-account", {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
    },
  });

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.tabsglobal.co/v1/wallets/virtual-account",
      headers={"Authorization": f"Bearer {API_KEY}"},
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "accountNumber": "9948102941",
    "accountName": "TABS / ACME VENTURES",
    "bankName": "Wema Bank",
    "bankCode": "035",
    "currency": "NGN",
    "status": "ACTIVE"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.