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

# Get Balance

> Retrieve your business's cNGN balances

Returns the cNGN balance(s) held by your business account.

### Response (decrypted `data`)

<ResponseField name="data" type="object[]">
  Array of asset balances.

  <Expandable title="Balance object">
    <ResponseField name="asset_type" type="string">
      Asset classification (e.g. `credit_alphanum4`).
    </ResponseField>

    <ResponseField name="asset_code" type="string">
      Asset ticker (`CNGN`).
    </ResponseField>

    <ResponseField name="balance" type="string">
      Current available balance as a decimal string.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.cngn.co/v1/api/balance" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json"
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch("https://api.cngn.co/v1/api/balance", {
    headers: { Authorization: `Bearer ${API_KEY}` },
  });
  ```

  ```python Python theme={null}
  res = requests.get(
      "https://api.cngn.co/v1/api/balance",
      headers={"Authorization": f"Bearer {API_KEY}"},
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success (data shown decrypted) theme={null}
  {
    "status": 200,
    "message": "Balance fetched successfully",
    "data": [
      {
        "asset_type": "credit_alphanum4",
        "asset_code": "CNGN",
        "balance": "150000.00"
      }
    ]
  }
  ```

  ```json 400 - Error theme={null}
  {
    "status": 400,
    "message": "Merchant not found"
  }
  ```
</ResponseExample>