---
title: "Reconcile My Subscription"
method: POST
path: "/v1/me/subscription/reconcile"
---

# Reconcile My Subscription

`POST /v1/me/subscription/reconcile`

## Request

- Base URL: `https://api.transcript.land` (the document declares no server; this is the origin it was published from)
- URL: `https://api.transcript.land/v1/me/subscription/reconcile`
- Auth: none declared

Pull the caller's subscription straight from Polar and apply the tier it
grants, so a checkout upgrade takes effect immediately on return instead of
waiting on the webhook (which may be delayed, or undeliverable in local
dev). Idempotent and safe to poll. Also surfaces the scheduled-cancel
state. No-op when billing isn't configured / there's no active subscription.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- SubscriptionResponse
  - `tier` string, required
  - `limit_seconds` integer, required
  - `used_seconds` integer, required
  - `cancel_at_period_end` boolean
  - `current_period_end` string, nullable
  - `pending_tier` string, nullable
  - `pending_change_at` string, nullable
  - `payment_state` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/transcript/apis/transcript-api.md) · [All operations](https://skmtc.dev/transcript/apis/transcript-api/llms.txt) · [OpenAPI document](https://skmtc.dev/transcript/apis/transcript-api/revisions/224a4605e044?raw)