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

# Get wallet

> Retrieve your current wallet balance and configuration.

Returns the authenticated account's wallet balance, payment threshold, auto top-up configuration, and saved-card status.

<Note>
  All monetary values in this response are in **naira** (NGN), not kobo. Divide a kobo amount by 100 to get naira.
</Note>

## Query parameters

None.

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.vouchmark.com/v1/wallet \
    -H "Authorization: Bearer $TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "wallet": {
      "balance": 50000,
      "paymentThreshold": 10000,
      "autoTopUp": {
        "enabled": true,
        "triggerBelow": 5000,
        "rechargeAmount": 100000
      },
      "hasSavedCard": true,
      "currency": "NGN"
    }
  }
  ```
</ResponseExample>

## Response fields

<ResponseField name="success" type="boolean" />

<ResponseField name="wallet" type="object">
  <Expandable title="wallet">
    <ResponseField name="balance" type="number">
      Current wallet balance in naira.
    </ResponseField>

    <ResponseField name="paymentThreshold" type="number">
      Minimum balance threshold in naira.
    </ResponseField>

    <ResponseField name="autoTopUp" type="object">
      <Expandable title="autoTopUp">
        <ResponseField name="enabled" type="boolean" />

        <ResponseField name="triggerBelow" type="number">
          Balance in naira at which auto top-up triggers.
        </ResponseField>

        <ResponseField name="rechargeAmount" type="number">
          Amount in naira to recharge when triggered.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="hasSavedCard" type="boolean">
      Whether a reusable card is on file (required for auto top-up).
    </ResponseField>

    <ResponseField name="currency" type="string">
      Always `NGN`.
    </ResponseField>
  </Expandable>
</ResponseField>