---
title: "List user subscriptions"
method: GET
path: "/api/user-api/subscriptions"
tags: ["User API"]
---

# List user subscriptions

`GET /api/user-api/subscriptions`

## Request

- Base URL: `https://us-central1-paymentgateway-ab783.cloudfunctions.net/api`
- URL: `https://us-central1-paymentgateway-ab783.cloudfunctions.net/api/api/user-api/subscriptions`
- Auth: API key in header `x-api-key`

Retrieve all subscriptions for the authenticated user across all apps.

## Query parameters

- `status` 'active' | 'canceled' | 'past_due' | 'trialing'

## Response `200`

Subscriptions retrieved successfully

- object
  - `success` 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
  - `total` integer

## Other responses

- `401`: Missing or invalid authentication token

---

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