---
title: "Get Dunning Settings"
method: GET
path: "/v1/subscriptions/dunning_settings"
tags: ["Subscriptions"]
---

# Get Dunning Settings

`GET /v1/subscriptions/dunning_settings`

Get the merchant division's dunning (failed payment recovery) settings. If the division has never configured these settings, Bolt's defaults are returned.

## Query parameters

- `seller_id` string

## Headers

- `X-Publishable-Key` string, required
- `X-Bolt-Connect-Seller-Id` string

## Response `200`

Success

- SubscriptionV2DunningSettings — A merchant division's dunning (failed payment recovery) configuration.
  - `retry_schedule_hours` integer[], required — Hour offsets from the initial payment failure at which Bolt retries the payment. Must be 1-10 strictly increasing, positive values, each at most 2160 (90 days).
  - `reminder_lead_days` integer[], required — Days before a subscription's renewal at which Bolt sends the shopper a reminder. Must be 1-10 unique values between 1 and 90.
  - `final_action` 'cancel' | 'pause', required — The action Bolt takes on a subscription once the retry schedule is exhausted without a successful payment.
  - `sms_enabled` boolean, required — Whether Bolt sends SMS reminders and payment-failure notifications to the shopper, in addition to email.

## Other responses

- `401` — UNAUTHORIZED. Missing or invalid X-API-Key or X-Publishable-Key.

## Changes

- **2026-07-31** `1f62c40558c6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bolt/apis/bolt-api-reference/changes/v1/subscriptions/dunning_settings/get.md)

---

[API](https://skmtc.dev/bolt/apis/bolt-api-reference.md) · [All operations](https://skmtc.dev/bolt/apis/bolt-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bolt/bolt-api-reference/revisions/1f62c40558c6/schema)