---
title: "Get auto-refill: when the balance drops below a threshold, Audo charges the saved card for more credits"
method: GET
path: "/api/v1/auto-refill"
tags: ["Account"]
---

# Get auto-refill: when the balance drops below a threshold, Audo charges the saved card for more credits

`GET /api/v1/auto-refill`

## Request

- Base URL: `https://audo.ai`
- URL: `https://audo.ai/api/v1/auto-refill`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-audo.session_token`

Read-only with a key or an assistant. Only a person signed in at audo.ai can turn it on, change it, or turn it off, at setupUrl.

## Response `200`

OK

- object
  - `enabled` boolean, required
  - `thresholdCents` integer, required: Refill when the available balance drops below this, in US cents
  - `amountCents` integer, required: What each refill adds to the balance, in US cents (tax, if any, is charged on top)
  - `monthlyCapCents` integer, required: The most charged for refills in a calendar month (UTC), in US cents before tax
  - `spentThisMonthCents` integer, required: Charged for refills this calendar month, in US cents before tax
  - `card` object, nullable, required: The saved card, or null
    - `brand` string, nullable, required
    - `last4` string, nullable, required
  - `disabledReason` 'card_declined' | 'authentication_required' | 'payment_failed' | 'disputed', nullable, required: Why auto-refill turned itself off, or null: card_declined, authentication_required, payment_failed, or disputed
  - `setupUrl` string, required: Where a person turns auto-refill on or changes it

## Other responses

- `default`: An error, with what went wrong and what to do next

---

[API](https://skmtc.dev/audo/apis/audo-api.md) · [All operations](https://skmtc.dev/audo/apis/audo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/audo/apis/audo-api/revisions/0800e93224eb?raw)