Dashboard
APIList Subscriptions | Subscription Bot API
api.botsubscription.com
GET/v1/endpoint
AuthenticationBearer
Token
Stays in this tab. Required for this endpoint — the value below is what gets sent.
Examples
curl --request GET \
  --url https://api.botsubscription.com/v1/endpoint \
  --header 'Authorization: Bearer sk_live_•••'

List Subscriptions

GET/v2/projects/{project_id}/subscriptions

Authorization

Bearer API KeyRequired

API key access: subscriptions:read; restricted keys MUST supply user_id; unrestricted keys may omit it to list all.

List recurring billing subscriptions, newest start date first, then subscription ID ascending. Restricted keys must supply user_id; unrestricted keys can omit it to list the project.

Status filters accept active, paused, or cancelled without case sensitivity. Response status values use uppercase. Pagination returns total alongside data; it does not echo limit or offset.

Use each returned internal UUID with Get Subscription or Cancel Subscription.

Path Parameters

project_idstringrequired

Project UUID.

Query Parameters

user_idstring

External Telegram user ID or Discord snowflake as a string. Required for restricted keys.

statusstring

active, paused, or cancelled; case-insensitive.

limitinteger

Page size from 1 to 100; default 10.

offsetinteger

Nonnegative offset; default 0.

See the project API authentication rules for shared request and retry behavior.

Last updated: