---
title: "Get Refund Preview"
method: GET
path: "/v1/subscriptions/{id}/refund_preview"
tags: ["Subscriptions"]
---

# Get Refund Preview

`GET /v1/subscriptions/{id}/refund_preview`

Previews the prorated refund that would result from canceling a subscription. Runs the
same validation as a real prorated refund but issues no refund and creates no records, so
it is safe to call repeatedly. Returns the prorated amount available to refund, the amount
paid on the latest invoice, the current billing period, and the card that would be
refunded.

## Path parameters

- `id` string, required

## Response `200`

The result of previewing a prorated refund for a subscription cancellation, without issuing any refund. Reflects what would be refunded based on the remaining billing period.

- RefundPreviewResponse — The result of previewing a prorated refund for a subscription cancellation, without issuing any refund. Reflects what would be refunded based on the remaining billing period.
  - `prorated_amount_available_to_refund` integer, required — Prorated amount available to refund, in the smallest currency unit (e.g., `1499` = $14.99 USD), based on the unused portion of the current billing period.
  - `invoice_amount_paid` integer, required — Total amount paid on the subscription's latest invoice, in the smallest currency unit (e.g., `2999` = $29.99 USD).
  - `current_period_start` string, required — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
  - `current_period_end` string, required — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
  - `payment_method_id` string, nullable — The payment method ID that would be refunded, if available
  - `last4` string, nullable — Last 4 digits of the card that would be refunded, if available

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation Error
- `429` — Too Many Requests

---

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