---
title: "Refresh Subscription"
method: POST
path: "/api/auth/me/subscription/refresh"
tags: ["Auth"]
---

# Refresh Subscription

`POST /api/auth/me/subscription/refresh`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/auth/me/subscription/refresh`
- Auth: HTTP bearer

Bring the user's tier up to date and return the EFFECTIVE tier.

The app calls this the moment a purchase or restore completes (and holds
an "activating" screen until it answers paid), so a subscriber never sits
behind free-tier walls waiting for a webhook. Idempotent; safe to poll.

1. Replays any webhook events for this user that were kept unmatched or
   failed.
2. Asks RevenueCat directly (when REVENUECAT_API_KEY is set).

## Response `200`

Successful Response

- unknown

---

[API](https://skmtc.dev/earmarkiq/apis/earmark-api.md) · [All operations](https://skmtc.dev/earmarkiq/apis/earmark-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earmarkiq/apis/earmark-api/revisions/4a2c41907105?raw)