---
title: "Cancel My Subscription"
method: POST
path: "/v1/me/subscription/cancel"
---

# Cancel My Subscription

`POST /v1/me/subscription/cancel`

## 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/cancel`
- Auth: none declared

Schedule the caller's subscription to cancel at the end of the current
billing period. They keep their current tier until then (Polar fires
subscription.canceled now, and subscription.revoked at period end, which
the webhook turns into a downgrade to free). Returns the updated state.

## 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)