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

Get Target - Fetch Access Destination Details via API

Fetch complete details for a single access destination by its internal ID. The response includes the target's platform (Discord or Telegram), type (role, channel, or group), enabled status, linked plan count, and current member count.

GET/v2/projects/{project_id}/targets/{target_id}

Authorization

Bearer TokenRequired

Path Parameters

project_idstringrequired

The unique identifier of the project.

target_idstringrequired

The internal target ID (UUID).

curl -X GET "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/targets/11111111-1111-1111-1111-111111111111" \
  -H "Authorization: Bearer YOUR_TOKEN"

const project_id = 'YOUR_PROJECT_ID';
const target_id = '11111111-1111-1111-1111-111111111111';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/targets/${target_id}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN'
  }
});
const data = await response.json();

import requests
 
project_id = 'YOUR_PROJECT_ID'
target_id = '11111111-1111-1111-1111-111111111111'
response = requests.get(
    f'https://api.botsubscription.com/v2/projects/{project_id}/targets/{target_id}',
    headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
data = response.json()

$project_id = 'YOUR_PROJECT_ID';
$target_id = '11111111-1111-1111-1111-111111111111';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/targets/{$target_id}");
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/targets/11111111-1111-1111-1111-111111111111",
  "code": 200,
  "total": 1,
  "data": [
    {
      "target_id": "11111111-1111-1111-1111-111111111111",
      "target_name": "Premium Members",
      "platform": "discord",
      "kind": "role",
      "external_id": "123456789012345678",
      "is_enabled": true,
      "plan_count": 3,
      "parent_target_id": "22222222-2222-2222-2222-222222222222",
      "participant_count": 150
    }
  ]
}

Target not found (empty result)application/json

{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "GET",
  "path": "/v2/projects/YOUR_PROJECT_ID/targets/11111111-1111-1111-1111-111111111111",
  "code": 200,
  "total": 0,
  "data": []
}

Invalid UUID formatapplication/json

{
  "ok": false,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "GET",
  "path": "/v2/projects/YOUR_PROJECT_ID/targets/invalid-id",
  "code": 422,
  "errors": [
    {
      "message": "target_id Invalid UUID",
      "error_code": "VALIDATION_ERROR"
    }
  ]
}

Last updated: May 28, 2026