---
title: "Read the account's auto top-up configuration (enabled, threshold, amount, saved card, monthly spend)"
method: GET
path: "/v1/credit/auto-topup"
---

# Read the account's auto top-up configuration (enabled, threshold, amount, saved card, monthly spend)

`GET /v1/credit/auto-topup`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/credit/auto-topup`
- Auth: HTTP bearer

Auto top-up status: enabled/disabled, threshold, amount, saved card (brand and last four digits only), spend and cap for this calendar month.

## Response `200`

Auto top-up state

- object
  - `autoTopup` object, required
    - `enabled` boolean, required
    - `thresholdHal` number, nullable, required
    - `amountHal` number, nullable, required
    - `card` object, nullable, required
      - `brand` string, required
      - `last4` string, required
    - `spentThisMonthHal` number, required
    - `monthlyCapHal` number, required
    - `disabledReason` 'card_declined' | 'authentication_required' | 'monthly_cap' | 'daily_cap', nullable, required

## Other responses

- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)