api.botsubscription.com
GET /v1/endpoint
Authentication Bearer
Token
Stays in this tab. Required for this endpoint — the value below is what gets sent.
Request GET Response —
cURL Node Python PHP Go Ruby
Copy curl --request GET \
--url https://api.botsubscription.com/v1/endpoint \
--header 'Authorization: Bearer sk_live_•••'— — · — · —
Response will appear here.
GET /v2/projects/ {project_id} /subscriptions CopyTry it Authorization Bearer API Key Required
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 .
Query Parameters External Telegram user ID or Discord snowflake as a string. Required for restricted keys.
active, paused, or cancelled; case-insensitive.
Page size from 1 to 100; default 10.
Nonnegative offset; default 0.
curl -X GET "https://api.botsubscription.com/v2/projects/11111111-1111-4111-8111-111111111111/subscriptions?user_id=123456789012345678&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY" Success application/json
{
"ok" : true ,
"request_id" : "44444444-4444-4444-8444-444444444444" ,
"method" : "GET" ,
"path" : "/v2/projects/11111111-1111-4111-8111-111111111111/subscriptions" ,
"code" : 200 ,
"message" : "Subscriptions retrieved successfully" ,
"total" : 1 ,
"data" : [
{
"merchant_account_provider" : "paypal" ,
"plan_id" : "33333333-3333-4333-8333-333333333333" ,
"subscription_id" : "22222222-2222-4222-8222-222222222222" ,
"subscription_start_date" : "2026-11-01T10:00:00.000Z" ,
"subscription_status" : "ACTIVE" ,
"user_id" : "123456789012345678" ,
"provider" : "paypal" ,
"payment_request_id" : "44444444-4444-4444-8444-444444444444" ,
"subscription_end_date" : "2026-12-01T10:00:00.000Z" ,
"selected_currency" : null
}
]
} Missing user id application/json
{
"ok" : false ,
"request_id" : "44444444-4444-4444-8444-444444444444" ,
"method" : "GET" ,
"path" : "/v2/projects/11111111-1111-4111-8111-111111111111/subscriptions" ,
"code" : 403 ,
"error" : {
"error_code" : "FORBIDDEN" ,
"message" : "Scoped API keys must request a specific user_id; listing all subscriptions is not permitted."
}
} UNAUTHORIZED application/json
{
"ok" : false ,
"request_id" : "44444444-4444-4444-8444-444444444444" ,
"method" : "GET" ,
"path" : "/v2/projects/11111111-1111-4111-8111-111111111111/subscriptions" ,
"code" : 401 ,
"error" : {
"error_code" : "UNAUTHORIZED" ,
"message" : "Invalid or expired authentication token."
}
} VALIDATION_ERROR application/json
{
"ok" : false ,
"request_id" : "44444444-4444-4444-8444-444444444444" ,
"method" : "GET" ,
"path" : "/v2/projects/11111111-1111-4111-8111-111111111111/subscriptions" ,
"code" : 422 ,
"error" : {
"error_code" : "VALIDATION_ERROR" ,
"message" : "Invalid request parameters."
}
} See the project API authentication rules for shared request and retry behavior.
Last updated: November 17, 2026