API Reference
- GETAPI Overview
- SDK Setup
- Events
- Customers
- Entitlements
- Subscriptions
- Plans
- Invoices
- Credits
Subscriptions
Update a subscription
Cancel auto-renew or change the end date of a subscription.
POST
/
api
/
subscriptions
/
{subscription_id}
/
update
/
Copy
Ask AI
curl --request POST \
--url https://api.uselotus.io/api/subscriptions/{subscription_id}/update/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"turn_off_auto_renew": true,
"end_date": "2023-11-07T05:31:56Z",
"metadata": {}
}'
Copy
Ask AI
{
"subscription_id": "<string>",
"start_date": "2023-11-07T05:31:56Z",
"end_date": "2023-11-07T05:31:56Z",
"auto_renew": true,
"is_new": true,
"subscription_filters": [
{
"value": "<string>",
"property_name": "<string>"
}
],
"customer": {
"customer_name": "<string>",
"email": "jsmith@example.com",
"customer_id": "<string>"
},
"billing_plan": {
"plan_name": "<string>",
"plan_id": "<string>",
"version_id": "<string>",
"version": 123
},
"fully_billed": true,
"addons": [
{
"addon_subscription_id": "<string>",
"start_date": "2023-11-07T05:31:56Z",
"end_date": "2023-11-07T05:31:56Z",
"addon": {
"addon_name": "<string>",
"addon_id": "<string>",
"addon_type": "flat",
"billing_frequency": "one_time"
},
"fully_billed": true
}
],
"metadata": {}
}
Copy
Ask AI
lotus.update_subscription(
subscription_id='sub_a623349004cd4947aca1851c64aa6fbd',
turn_off_auto_renew=True
)
lotus.update_subscription(
subscription_id='sub_a623349004cd4947aca1851c64aa6fbd',
end_date='2022-02-23 03:30:00+00:00',
)
Authorizations
Token-based authentication with required prefix "Token"
Path Parameters
The ID of the subscription to update.
Body
Response
200 - application/json
The response is of type object
.
Copy
Ask AI
curl --request POST \
--url https://api.uselotus.io/api/subscriptions/{subscription_id}/update/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"turn_off_auto_renew": true,
"end_date": "2023-11-07T05:31:56Z",
"metadata": {}
}'
Copy
Ask AI
{
"subscription_id": "<string>",
"start_date": "2023-11-07T05:31:56Z",
"end_date": "2023-11-07T05:31:56Z",
"auto_renew": true,
"is_new": true,
"subscription_filters": [
{
"value": "<string>",
"property_name": "<string>"
}
],
"customer": {
"customer_name": "<string>",
"email": "jsmith@example.com",
"customer_id": "<string>"
},
"billing_plan": {
"plan_name": "<string>",
"plan_id": "<string>",
"version_id": "<string>",
"version": 123
},
"fully_billed": true,
"addons": [
{
"addon_subscription_id": "<string>",
"start_date": "2023-11-07T05:31:56Z",
"end_date": "2023-11-07T05:31:56Z",
"addon": {
"addon_name": "<string>",
"addon_id": "<string>",
"addon_type": "flat",
"billing_frequency": "one_time"
},
"fully_billed": true
}
],
"metadata": {}
}
Assistant
Responses are generated using AI and may contain mistakes.