api.botsubscription.com

GET/v1/endpoint

AuthenticationBearer

Token

Stays in this tab. Required for this endpoint — the value below is what gets sent.

Path parameters0

Query parameters0

BodyJSON

Mock

curl --request GET \
  --url https://api.botsubscription.com/v1/endpoint \
  --header 'Authorization: Bearer sk_live_•••'

List Project Plans - Get All Subscription Bot Pricing Tiers

Fetch all subscription plans configured for your project. Each plan includes pricing details, billing duration, recurring payment settings, and the Telegram channels or Discord roles it grants access to. Use this to sync your pricing page or build custom checkout flows.

GET/v2/projects/{project_id}/plans

Authorization

Bearer TokenRequired

Path Parameters

project_idstringrequired

The unique identifier of the project.

Query Parameters

limitintegerDefault: 20

Number of items per page.

offsetintegerDefault: 0

Number of items to skip.

curl -X GET "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/plans?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}/plans?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}/plans',
    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}/plans?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/plans",
  "code": 200,
  "total": 3,
  "message": "Plans retrieved successfully",
  "data": [
    {
      "plan_name": "Bronze",
      "plan_price": "10",
      "plan_currency": "USD",
      "plan_duration": "1 hour",
      "plan_price_formatted": "$10.00",
      "plan_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "plan_data": {
        "plan_recurring": true,
        "plan_one_time": true
      },
      "plan_targets": [
        {
          "target_name": "Members",
          "platform": "discord",
          "kind": "role",
          "external_id": "123456789012345678",
          "is_enabled": true,
          "target_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
          "parent_target_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
          "participant_count": 0
        }
      ]
    },
    {
      "plan_name": "Silver",
      "plan_price": "20",
      "plan_currency": "USD",
      "plan_duration": "1 day",
      "plan_price_formatted": "$20.00",
      "plan_id": "dddddddd-dddd-dddd-dddd-dddddddddddd",
      "plan_data": {
        "plan_recurring": false,
        "plan_one_time": true
      },
      "plan_targets": []
    },
    {
      "plan_name": "Gold",
      "plan_price": "100",
      "plan_currency": "USD",
      "plan_duration": "1 month",
      "plan_price_formatted": "$100.00",
      "plan_id": "eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee",
      "plan_data": {
        "plan_recurring": false,
        "plan_one_time": true
      },
      "plan_targets": []
    }
  ]
}

Last updated: May 28, 2026