api.botsubscription.com
GET /v1/endpoint
Authentication Bearer
Token
Stays in this tab. Required for this endpoint — the value below is what gets sent.
Request GET Response —
cURL Node Python PHP Go Ruby
Copy curl --request GET \
--url https://api.botsubscription.com/v1/endpoint \
--header 'Authorization: Bearer sk_live_•••'— — · — · —
Response will appear here.
GET /v2/projects/ {project_id} /subscriptions/ {subscription_id} CopyTry it Authorization Bearer API Key Required
API key access: subscriptions:read; unrestricted project keys also allowed.
Retrieve recurring billing state using its internal subscription UUID. This describes automatic renewal rather than membership access; a cancelled subscription can still have paid access remaining.
Use List Subscriptions to discover IDs and Cancellation Options before recording feedback. The response does not expose cancellation-feedback fields.
Path Parameters Internal subscription UUID, not a membership or payment ID.
curl -X GET "https://api.botsubscription.com/v2/projects/11111111-1111-4111-8111-111111111111/subscriptions/22222222-2222-4222-8222-222222222222" \
-H "Authorization: Bearer YOUR_API_KEY" Active application/json
{
"ok" : true ,
"request_id" : "44444444-4444-4444-8444-444444444444" ,
"method" : "GET" ,
"path" : "/v2/projects/11111111-1111-4111-8111-111111111111/subscriptions/22222222-2222-4222-8222-222222222222" ,
"code" : 200 ,
"message" : "Subscription retrieved successfully" ,
"data" : {
"merchant_account_provider" : "paypal" ,
"plan_id" : "33333333-3333-4333-8333-333333333333" ,
"subscription_id" : "22222222-2222-4222-8222-222222222222" ,
"subscription_start_date" : "2026-11-01T10:00:00.000Z" ,
"subscription_status" : "ACTIVE" ,
"user_id" : "123456789012345678" ,
"provider" : "paypal" ,
"payment_request_id" : "44444444-4444-4444-8444-444444444444" ,
"subscription_end_date" : "2026-12-01T10:00:00.000Z" ,
"selected_currency" : null
}
} Not found application/json
{
"ok" : false ,
"request_id" : "44444444-4444-4444-8444-444444444444" ,
"method" : "GET" ,
"path" : "/v2/projects/11111111-1111-4111-8111-111111111111/subscriptions/22222222-2222-4222-8222-222222222222" ,
"code" : 404 ,
"error" : {
"error_code" : "NOT_FOUND" ,
"message" : "Subscription not found"
}
} UNAUTHORIZED application/json
{
"ok" : false ,
"request_id" : "44444444-4444-4444-8444-444444444444" ,
"method" : "GET" ,
"path" : "/v2/projects/11111111-1111-4111-8111-111111111111/subscriptions/22222222-2222-4222-8222-222222222222" ,
"code" : 401 ,
"error" : {
"error_code" : "UNAUTHORIZED" ,
"message" : "Invalid or expired authentication token."
}
} FORBIDDEN application/json
{
"ok" : false ,
"request_id" : "44444444-4444-4444-8444-444444444444" ,
"method" : "GET" ,
"path" : "/v2/projects/11111111-1111-4111-8111-111111111111/subscriptions/22222222-2222-4222-8222-222222222222" ,
"code" : 403 ,
"error" : {
"error_code" : "FORBIDDEN" ,
"message" : "Access is not permitted."
}
} VALIDATION_ERROR application/json
{
"ok" : false ,
"request_id" : "44444444-4444-4444-8444-444444444444" ,
"method" : "GET" ,
"path" : "/v2/projects/11111111-1111-4111-8111-111111111111/subscriptions/22222222-2222-4222-8222-222222222222" ,
"code" : 422 ,
"error" : {
"error_code" : "VALIDATION_ERROR" ,
"message" : "Invalid request parameters."
}
} See the project API authentication rules for shared request and retry behavior.
Last updated: November 17, 2026