---
title: "Check subscription status"
method: POST
path: "/v1/subscription/check"
tags: ["Subscriptions"]
---

# Check subscription status

`POST /v1/subscription/check`

Checks subscription status across all providers (Apple, FunnelFox, Stripe) and returns the active subscription if found.

## Response `200`

Subscription status retrieved successfully

- SubscriptionCheckResponseDto
  - `isSubscribed` boolean, required — Whether user has an active subscription
  - `source` 'apple' | 'stripe' | 'funnelfox' | 'unlimit' | 'upgate' — Subscription source/provider
  - `expirationDate` string, date-time — Subscription expiration date
  - `status` string — Subscription status
  - `cancelAtPeriodEnd` boolean — Whether subscription will be cancelled at period end
  - `planName` string — Name of the subscription plan

---

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