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

# Accounts

> Manage your payment accounts and wallets

Manage your payment wallets and view balances. Use the returned account ID when initiating collections or transfers.

## Endpoints

| Endpoint                      | Method | Description                |
| ----------------------------- | ------ | -------------------------- |
| `/bila/accounts`              | GET    | List all accounts/wallets  |
| `/bila/accounts/{id}`         | GET    | Get a single account by ID |
| `/bila/accounts/{id}/balance` | GET    | Get account balance        |

## Account Object

```json theme={null}
{
  "id": "68f11209-451f-4a15-bfcd-d916eb8b09f4",
  "details": {
    "type": "wallet",
    "accountName": "My Business Wallet",
    "tillNumber": "123456"
  },
  "type": "primary",
  "status": "active",
  "createdAt": "2024-01-15T10:30:00Z",
  "currency": "ZMW"
}
```

## Balance Object

```json theme={null}
{
  "availableBalance": 15000.00,
  "ledgerBalance": 15500.00,
  "currency": "ZMW"
}
```

<Note>
  **Available Balance** is the amount you can withdraw or transfer. **Ledger Balance** includes pending transactions.
</Note>

## Use Cases

<AccordionGroup>
  <Accordion title="Check wallet balance before transfer">
    Before initiating a transfer, check your available balance to ensure sufficient funds.
  </Accordion>

  <Accordion title="Monitor multiple wallets">
    If you have multiple wallets, list them all and track balances across your organization.
  </Accordion>
</AccordionGroup>

<a href="/docs/api-reference" style={{ textDecoration: 'none', borderBottom: 'none', display: 'block' }}>
  <div
    style={{
  borderRadius: '16px',
  padding: '32px',
  height: '120px',
  display: 'flex',
  flexDirection: 'column',
  justifyContent: 'flex-end',
  border: '0.5px solid #f16101',
  cursor: 'pointer',
  transition: 'all 0.15s ease-in-out',
  boxShadow: '0 4px 14px 0 rgba(241, 97, 1, 0.1)',
}}
    onMouseEnter={e => {
  e.currentTarget.style.background = 'rgba(241, 97, 1, 0.05)';
  e.currentTarget.style.boxShadow = '0 6px 20px 0 rgba(241, 97, 1, 0.2)';
  e.currentTarget.style.transform = 'translateY(-2px)';
}}
    onMouseLeave={e => {
  e.currentTarget.style.background = 'transparent';
  e.currentTarget.style.boxShadow = '0 4px 14px 0 rgba(241, 97, 1, 0.1)';
  e.currentTarget.style.transform = 'none';
}}
  >
    <div style={{ fontSize: '24px', marginBottom: '8px' }}>⟡</div>
    <div style={{ fontWeight: '500', fontSize: '16px' }}>API Reference</div>
    <div style={{ opacity: 0.6, fontSize: '13px', marginTop: '4px' }}>Explore the complete API reference</div>
  </div>
</a>