---
title: "Get auto-refill settings"
method: GET
path: "/api/v1/auto-refill"
tags: ["Auto-Refill"]
---

# Get auto-refill settings

`GET /api/v1/auto-refill`

## Request

- Base URL: `https://investormatch.pro`
- URL: `https://investormatch.pro/api/v1/auto-refill`
- Auth: HTTP bearer

Returns your automatic credit top-up settings, or null if never configured. The saved payment method is masked. Authenticated and rate-limited.

## Response `200`

Auto-refill settings (or null).

- AutoRefillSettings, nullable: Null when the user has never configured auto-refill.
  - `enabled` boolean
  - `refill_threshold` integer: Trigger a top-up when the balance drops to/below this.
  - `refill_amount` integer: Credits added per top-up.
  - `stripe_payment_method_id` string, nullable: Masked saved card, e.g. '****4242'. Never the raw payment-method ID.
  - `monthly_limit` integer: Max credits auto-refilled per month.
  - `monthly_used` integer: Credits auto-refilled so far this month.

## Other responses

- `401`: Missing or invalid API key.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/investormatch/apis/investormatch-pro-api.md) · [All operations](https://skmtc.dev/investormatch/apis/investormatch-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/investormatch/apis/investormatch-pro-api/revisions/647f22300043?raw)