---
title: "Get subscription status"
method: GET
path: "/subscriptions/status"
tags: ["Subscriptions"]
---

# Get subscription status

`GET /subscriptions/status`

## Request

- Base URL: `https://us-central1-paymentgateway-ab783.cloudfunctions.net/api`
- URL: `https://us-central1-paymentgateway-ab783.cloudfunctions.net/api/subscriptions/status`
- Auth: HTTP bearer

Returns the active subscription for the authenticated user. Provide `x-app-id` header or `appId` query to target a specific app.

## Query parameters

- `appId` string

## Headers

- `x-app-id` string

## Response `200`

Subscription status retrieved

- object
  - `success` boolean
  - `status` string
  - `subscription` Subscription
    - `id` string: Subscription ID
    - `appId` string: Application identifier
    - `planId` 'free' | 'starter' | 'professional' | 'business' | 'enterprise'
    - `status` 'active' | 'canceled' | 'past_due' | 'trialing'
    - `currentPeriodEnd` string, date-time
    - `cancelAtPeriodEnd` boolean
  - `subscriptions` Subscription[]
    - `id` string: Subscription ID
    - `appId` string: Application identifier
    - `planId` 'free' | 'starter' | 'professional' | 'business' | 'enterprise'
    - `status` 'active' | 'canceled' | 'past_due' | 'trialing'
    - `currentPeriodEnd` string, date-time
    - `cancelAtPeriodEnd` boolean

## Other responses

- `401`: Missing or invalid authentication token
- `500`: Failed to retrieve subscription status

---

[API](https://skmtc.dev/futuresenseai/apis/futuresense-ai-central-hub-api.md) · [All operations](https://skmtc.dev/futuresenseai/apis/futuresense-ai-central-hub-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futuresenseai/apis/futuresense-ai-central-hub-api/revisions/53e075911af9?raw)