---
title: "Get auto-recharge config for a customer"
method: GET
path: "/v1/sdk/auto-recharge"
tags: ["Auto Recharge"]
---

# Get auto-recharge config for a customer

`GET /v1/sdk/auto-recharge`

Returns the stored auto-recharge configuration (and display block) for the given customer, or a null config when none is set.

## Query parameters

- `customerRef` string, required

## Response `200`

Current auto-recharge config, if present.

- AutoRechargeGetResponse
  - `config` AutoRechargeConfigDto
    - `enabled` boolean, required — Whether auto-recharge is enabled
    - `failureCount` number, required — Consecutive failure count
    - `fundingSourceType` 'saved_card' | 'tokenized_card', required — Funding source type
    - `inFlightPaymentIntentId` string — PaymentIntent ID of an in-flight recharge
    - `lastChargeAt` string — Timestamp of the last successful charge
    - `lockAcquiredAt` string — Timestamp the processing lock was acquired
    - `maxMonthlySpendMinor` number — Optional monthly spend cap in topup.currency minor units
    - `monthlySpendMinor` number, required — Successful auto-recharge spend in the current UTC month
    - `monthlySpendPeriod` string — UTC YYYY-MM period key for monthlySpendMinor
    - `paymentMethodId` string — Saved payment method ID backing the recharge
    - `status` 'active' | 'disabled' | 'failed' | 'pending_setup', required — Current config status
    - `topup` AutoRechargeTopupDto, required
      - `amountMinor` number, required — Top-up amount in currency minor units
      - `currency` string, required — ISO 4217 currency code
      - `mode` 'fixed', required — Top-up mode
    - `trigger` AutoRechargeTriggerDto, required
      - `thresholdAmountMinor` number, required — Display-currency minor units for the balance threshold
      - `type` 'balance', required — Trigger kind
    - `updatedAt` string, required — Last update timestamp
  - `display` AutoRechargeDisplayDto
    - `currency` string, required — Display currency code
    - `exchangeRate` number, required — Exchange rate used for display conversion
    - `formatted` AutoRechargeDisplayFormattedDto, required
      - `threshold` string, required — Formatted threshold amount
      - `topup` string, required — Formatted top-up amount
    - `rateSource` string, required — Source of the exchange rate
    - `thresholdAmountMajor` number, required — Threshold amount in display-currency major units
    - `topupAmountMajor` number, required — Top-up amount in display-currency major units

## Other responses

- `400` — customerRef query parameter is required

---

[API](https://skmtc.net/solvapay/apis/solvapay-rest-api.md) · [All operations](https://skmtc.net/solvapay/apis/solvapay-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solvapay/solvapay-rest-api/revisions/bbc2ff2bc849/schema)