/api/v1/vpn/subscriptionsВсе подписки аккаунта, включая проданные через ботов. Без живого трафика: он есть только в карточке одной подписки.
curl https://api.relayhub.surf/api/v1/vpn/subscriptions \
-H "Authorization: Bearer <YOUR_API_KEY>"{
"success": true,
"total": 1,
"offset": 0,
"limit": 20,
"items": [
{
"subscription_id": "01a06315-1270-705a-8d4c-58fea607bf2c",
"external_user_id": "user-42",
"plan_uuid": "550e8400-e29b-41d4-a716-446655440000",
"plan_name": "Standart 30d",
"is_trial": false,
"status": "active",
"subscription_url": "https://api.relayhub.surf/sub/wnT9NRf0Zk6McRRnp2nggc3K",
"days": 30,
"days_left": 30,
"devices": 2,
"auto_renew": false,
"renewal_count": 0,
"created_at": "2026-09-02T12:00:00Z",
"end_date": "2026-10-02T12:00:00Z",
"price_minor": 450,
"price_usd": "4.50"
}
]
}Заголовок Authorization: Bearer <ключ> на каждом запросе. Ключ один на аккаунт, выпускается в кабинете партнёра и показывается один раз. Он тратит депозит: держите его на сервере.
external_user_idнеобязательноТолько подписки этого пользователя.
statusнеобязательноФильтр по статусу.
offsetнеобязательноСколько пропустить.
limitнеобязательноРазмер страницы, до 100.
successbooleanобязательноtotalintegerобязательноoffsetintegerобязательноlimitintegerобязательноitemsobject[]обязательно401unauthorized: Неверный или отсутствующий API-ключ403api_disabled: Доступ к API для этого аккаунта закрыт422validation_error: Неверные параметры запроса429rate_limited: Слишком много запросов503upstream_unavailable: Поставщик VPN временно недоступенcurl https://api.relayhub.surf/api/v1/vpn/subscriptions \
-H "Authorization: Bearer <YOUR_API_KEY>"{
"success": true,
"total": 1,
"offset": 0,
"limit": 20,
"items": [
{
"subscription_id": "01a06315-1270-705a-8d4c-58fea607bf2c",
"external_user_id": "user-42",
"plan_uuid": "550e8400-e29b-41d4-a716-446655440000",
"plan_name": "Standart 30d",
"is_trial": false,
"status": "active",
"subscription_url": "https://api.relayhub.surf/sub/wnT9NRf0Zk6McRRnp2nggc3K",
"days": 30,
"days_left": 30,
"devices": 2,
"auto_renew": false,
"renewal_count": 0,
"created_at": "2026-09-02T12:00:00Z",
"end_date": "2026-10-02T12:00:00Z",
"price_minor": 450,
"price_usd": "4.50"
}
]
}