POST
/
api
/
subscriptions
/
update
/
curl --request POST \
  --url https://api.uselotus.io/api/subscriptions/update/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "replace_plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invoicing_behavior": "invoice_now",
  "usage_behavior": "transfer_to_new_subscription",
  "turn_off_auto_renew": true,
  "end_date": "2023-11-07T05:31:56Z"
}'
[
  {
    "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": {}
  }
]
lotus.update_subscription(
  customer_id='cust_0569173ee6654369',
  plan_id="plan_123",
  replace_plan_id="plan_456",
  invocing_behavior="add_to_next_invoice",
  turn_off_auto_renew=True
)

lotus.update_subscription(
  customer_id='cust_0569173ee6654369',
  plan_id="plan_123",
  subscription_filters=[{"property_name": "status", "value": "active"}],
  end_date=datetime.date(2022, 12, 8),
)

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Query Parameters

​
customer_id
string | null
required

Filter to a specific customer.

Minimum length: 1
​
plan_id
string
required

Filter to a specific plan.

​
subscription_filters
object[]

Filter to a specific set of subscription filters. If your billing model only allows for one subscription per customer, you very likely do not need this field. Must be formatted as a JSON-encoded + stringified list of dictionaries, where each dictionary has a key of 'property_name' and a key of 'value'.

Body

Response

200 - application/json

The response is of type object[].