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_•••'

Check Subscription Bot Access Token Eligibility

Preview whether your Telegram subscription bot or Discord subscription bot project can generate a batch of the requested size.

GET/v2/projects/{project_id}/access-tokens/eligibility

Authorization

Bearer TokenRequired

Requires memberships:add for a human admin. Restricted project API keys need access-tokens:create.

Path Parameters

project_idstringrequired

The UUID of the project.

Query Parameters

countintegerDefault: 1

Requested batch size, from 1 to 100.

Behavior and recovery

Optional query count is 1–100, default 1. The response data contains allowed (boolean), remaining (integer or null), and reason (string or null). This is a preview; activation checks the current quota again. Unknown query fields return 422.

allowed is a boolean, remaining is an integer or null, and reason is a string or null. This preview does not reserve quota.

Use Prepare Tokens to save a batch, then Activate Tokens to issue it against the current quota.

curl -X GET "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/eligibility?count=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/eligibility?count=10", {
  method: 'GET',
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});
const result = await response.json();

import requests
 
response = requests.get(
    "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/eligibility?count=10",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    }
)
result = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/eligibility?count=10');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_TOKEN'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Generation eligibility previewapplication/json

{
  "ok": true,
  "request_id": "44444444-4444-4444-8444-444444444444",
  "method": "GET",
  "path": "/v2/projects/YOUR_PROJECT_ID/access-tokens/eligibility",
  "code": 200,
  "message": "Success",
  "data": {
    "allowed": true,
    "remaining": 90,
    "reason": null
  }
}

Last updated: October 19, 2026