curl --request POST \
--url {scheme}://{domain}/api/v1/aggregator/subscriptions \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"externalUserId": "abcd123",
"planCode": "68b74fd80e51671c21e46913",
"startDate": "2025-09-03T11:30:00.000Z",
"endDate": "2025-12-02T11:30:00.000Z",
"device": "android_phone"
}
'{
"subscriptionId": "sub_01J8Z3Z2Y6M3X4",
"externalUserId": "aysgte536d8sgh",
"planCode": "configuredPlanCode",
"startDate": "2020-09-04T11:23:42.958Z",
"endDate": "2020-10-04T11:22:23.958Z",
"device": "android_phone",
"status": "completed"
}Subscriptions
Create Subscription
Creates a new subscription for a user against a given plan.
POST
/
subscriptions
curl --request POST \
--url {scheme}://{domain}/api/v1/aggregator/subscriptions \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"externalUserId": "abcd123",
"planCode": "68b74fd80e51671c21e46913",
"startDate": "2025-09-03T11:30:00.000Z",
"endDate": "2025-12-02T11:30:00.000Z",
"device": "android_phone"
}
'{
"subscriptionId": "sub_01J8Z3Z2Y6M3X4",
"externalUserId": "aysgte536d8sgh",
"planCode": "configuredPlanCode",
"startDate": "2020-09-04T11:23:42.958Z",
"endDate": "2020-10-04T11:22:23.958Z",
"device": "android_phone",
"status": "completed"
}Authorizations
Body
application/json
Aggregator's user identifier (stable across calls).
AscendOTT planCode to subscribe to.
UTC ISO8601. Optional. Defaults to current date/time.
UTC ISO8601. Optional. Defaults to plan duration.
Origin device of the purchase. Optional.
Available options:
web_browser, android_phone, ios_phone, android_tablet, ios_tablet, android_tv, smart_tv, roku, fire_tv, apple_tv, jio_stb, other Response
Created
Available options:
completed, pending, cancelled, expired Available options:
web_browser, android_phone, ios_phone, android_tablet, ios_tablet, android_tv, smart_tv, roku, fire_tv, apple_tv, jio_stb, other