---
title: "Get self-serve refund eligibility"
method: GET
path: "/premium/refund-eligibility"
tags: ["Billing"]
---

# Get self-serve refund eligibility

`GET /premium/refund-eligibility`

Returns whether the authenticated user can self-serve refund their most recent purchase, including the refund window and cooldown timestamps.

## Response `200`

Success

- SelfServeRefundEligibilityResponse
  - `eligible` boolean, required — Whether the authenticated user can self-serve refund their latest purchase right now
  - `reason` 'no_refundable_purchase' | 'outside_refund_window' | 'cooldown_active' | 'feature_unavailable', required
  - `invoice_id` string, nullable, required — Latest paid invoice considered for refund eligibility
  - `invoice_amount_paid_cents` integer, nullable, required — Amount paid on the latest invoice in the currency minor unit
  - `currency` string, nullable, required — Currency of the latest paid invoice
  - `paid_at` string, nullable, required — ISO timestamp the latest invoice was paid
  - `refund_window_expires_at` string, nullable, required — ISO timestamp after which the 3-day refund window closes
  - `cooldown_expires_at` string, nullable, required — ISO timestamp the 30-day cooldown ends, if currently active
  - `cancels_subscription` boolean, required — Whether issuing the refund will also cancel the active subscription

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid data
- `401` — Unauthorized - Authentication is required or the token is invalid
- `403` — Forbidden - You do not have permission to perform this action
- `429` — Too Many Requests - You are being rate limited
- `500` — Internal Server Error - An unexpected error occurred

---

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