List Memberships - View Active Subscriptions in Your Bot

Get all active and past subscriptions across your project. Each membership record shows which user holds it, the plan they purchased, subscription dates, and renewal status. You can filter by user ID to view a specific member's subscription history.

GET/v2/projects/{project_id}/memberships

Authorization

Bearer TokenRequired

Path Parameters

project_idstringRequired

The unique identifier of the project.

Query Parameters

user_idstring

Filter memberships by user ID.

limitintegerDefault: 20

Number of items per page.

offsetintegerDefault: 0

Number of items to skip.

Request

curl -X GET "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/memberships?limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN"

const project_id = 'YOUR_PROJECT_ID';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/memberships?limit=20`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN'
  }
});
const data = await response.json();

import requests
 
project_id = 'YOUR_PROJECT_ID'
response = requests.get(
    f'https://api.botsubscription.com/v2/projects/{project_id}/memberships',
    params={'limit': 20},
    headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
data = response.json()

$project_id = 'YOUR_PROJECT_ID';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/memberships?limit=20");
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Successapplication/json

{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "GET",
  "path": "/v2/projects/YOUR_PROJECT_ID/memberships",
  "code": 200,
  "total": 1,
  "message": "All memberships retrieved successfully",
  "data": [
    {
      "user_id": "123456789012345678",
      "plan_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "membership_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
      "payment_request_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
      "membership_start_date": "2025-12-29T10:32:27.560Z",
      "membership_end_date": "2026-01-12T10:32:27.560Z",
      "user_name": {
        "first_name": "John",
        "username": "johndoe"
      },
      "plan_name": "Silver",
      "plan_duration": "1 day",
      "subscription_id": null,
      "subscription_status": null
    }
  ]
}

Last updated: January 25, 2026

API Endpoint

List Memberships - View Active Subscriptions in Your Bot

Authorization

Path Parameters

Query Parameters