--- title: "Changes to Terminate a subscription" method: DELETE path: "/subscriptions/{external_id}" --- # Changes to Terminate a subscription `DELETE /subscriptions/{external_id}` > Every recorded change to this operation, newest first. ## Timeline Changed in 9 of 14 revisions. - **2026-11-03** `5d26657495a3`: 1 info - **2026-10-16** `fce1879654d8`: 24 breaking, 9 warning, 3 info - **2026-07-26** `6e969ef3bb45`: 1 warning, 5 info - **2026-05-20** `24e860ade740`: 1 breaking, 27 info - **2026-01-16** `7bf10db291f4`: 4 breaking, 3 warning, 32 info - **2025-06-09** `083d895c3f8e`: 3 info - **2025-01-06** `e5683732fee1`: 1 breaking - **2024-12-22** `e1b7ed77904e`: 5 breaking, 9 warning - **2024-12-09** `d7f5a2be797e`: 3 breaking, 138 warning, 32 info ## Changes - **2026-11-03** `5d26657495a3`: 1 info - added the non-success response with the status `405` - **2026-10-16** `fce1879654d8`: 24 breaking, 9 warning, 3 info - for the `query` request parameter `status`, default value `active` was added - the `subscription` response's property type changed from `object` to no type for status `200` - removed the required property `subscription/billing_time` from the response with the `200` status - removed the required property `subscription/canceled_at` from the response with the `200` status - removed the required property `subscription/created_at` from the response with the `200` status - removed the required property `subscription/current_billing_period_ending_at` from the response with the `200` status - removed the required property `subscription/current_billing_period_started_at` from the response with the `200` status - removed the required property `subscription/downgrade_plan_date` from the response with the `200` status - removed the required property `subscription/ending_at` from the response with the `200` status - removed the required property `subscription/external_customer_id` from the response with the `200` status - removed the required property `subscription/external_id` from the response with the `200` status - removed the required property `subscription/lago_customer_id` from the response with the `200` status - removed the required property `subscription/lago_id` from the response with the `200` status - removed the required property `subscription/name` from the response with the `200` status - removed the required property `subscription/next_plan_code` from the response with the `200` status - removed the required property `subscription/on_termination_credit_note` from the response with the `200` status - removed the required property `subscription/on_termination_invoice` from the response with the `200` status - removed the required property `subscription/plan_code` from the response with the `200` status - removed the required property `subscription/previous_plan_code` from the response with the `200` status - removed the required property `subscription/started_at` from the response with the `200` status - removed the required property `subscription/status` from the response with the `200` status - removed the required property `subscription/subscription_at` from the response with the `200` status - removed the required property `subscription/terminated_at` from the response with the `200` status - removed the required property `subscription/trial_ended_at` from the response with the `200` status - removed the optional property `subscription/activated_at` from the response with the `200` status - removed the optional property `subscription/activation_rules` from the response with the `200` status - removed the optional property `subscription/applied_invoice_custom_sections` from the response with the `200` status - removed the optional property `subscription/billing_entity_code` from the response with the `200` status - removed the optional property `subscription/cancellation_reason` from the response with the `200` status - removed the optional property `subscription/consolidate_invoice` from the response with the `200` status - removed the optional property `subscription/payment_method` from the response with the `200` status - removed the optional property `subscription/plan_amount_cents` from the response with the `200` status - removed the optional property `subscription/plan_amount_currency` from the response with the `200` status - added the new enum value `offset` to the `query` request parameter `on_termination_credit_note` - added the optional property `authorization` to the response with the `200` status - added `#/components/schemas/SubscriptionObject, subschema #2` to the `subscription` response property `allOf` list for the response status `200` - **2026-07-26** `6e969ef3bb45`: 1 warning, 5 info - added the new `incomplete` enum value to the `subscription/status` response property for the response status `200` - added the optional property `subscription/activated_at` to the response with the `200` status - added the optional property `subscription/activation_rules` to the response with the `200` status - added the optional property `subscription/billing_entity_code` to the response with the `200` status - added the optional property `subscription/cancellation_reason` to the response with the `200` status - added the optional property `subscription/consolidate_invoice` to the response with the `200` status - **2026-05-20** `24e860ade740`: 1 breaking, 27 info - the `subscription` response's property type changed from no type to `object` for status `200` - added the optional property `subscription/applied_invoice_custom_sections` to the response with the `200` status - added the optional property `subscription/payment_method` to the response with the `200` status - added the optional property `subscription/plan_amount_cents` to the response with the `200` status - added the optional property `subscription/plan_amount_currency` to the response with the `200` status - removed `#/components/schemas/SubscriptionObject, subschema #2` from the `subscription` response property `allOf` list for the response status `200` - added the required property `subscription/billing_time` to the response with the `200` status - added the required property `subscription/canceled_at` to the response with the `200` status - added the required property `subscription/created_at` to the response with the `200` status - added the required property `subscription/current_billing_period_ending_at` to the response with the `200` status - added the required property `subscription/current_billing_period_started_at` to the response with the `200` status - added the required property `subscription/downgrade_plan_date` to the response with the `200` status - added the required property `subscription/ending_at` to the response with the `200` status - added the required property `subscription/external_customer_id` to the response with the `200` status - added the required property `subscription/external_id` to the response with the `200` status - added the required property `subscription/lago_customer_id` to the response with the `200` status - added the required property `subscription/lago_id` to the response with the `200` status - added the required property `subscription/name` to the response with the `200` status - added the required property `subscription/next_plan_code` to the response with the `200` status - added the required property `subscription/on_termination_credit_note` to the response with the `200` status - added the required property `subscription/on_termination_invoice` to the response with the `200` status - added the required property `subscription/plan_code` to the response with the `200` status - added the required property `subscription/previous_plan_code` to the response with the `200` status - added the required property `subscription/started_at` to the response with the `200` status - added the required property `subscription/status` to the response with the `200` status - added the required property `subscription/subscription_at` to the response with the `200` status - added the required property `subscription/terminated_at` to the response with the `200` status - added the required property `subscription/trial_ended_at` to the response with the `200` status - **2026-01-16** `7bf10db291f4`: 4 breaking, 3 warning, 32 info - the response property `subscription/allOf[subschema #2]/plan/charges/items/invoice_display_name` became nullable for the status `200` - the response property `subscription/allOf[subschema #2]/plan/charges/items/taxes/items/description` became nullable for the status `200` - the response property `subscription/allOf[subschema #2]/plan/minimum_commitment/taxes/items/description` became nullable for the status `200` - the response property `subscription/allOf[subschema #2]/plan/taxes/items/description` became nullable for the status `200` - added the new `GHS` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `semiannual` enum value to the `subscription/allOf[subschema #2]/plan/interval` response property for the response status `200` - added the new `semiannual` enum value to the `subscription/allOf[subschema #2]/plan/minimum_commitment/interval` response property for the response status `200` - added the new optional `query` request parameter `on_termination_credit_note` - added the new optional `query` request parameter `on_termination_invoice` - added the non-success response with the status `422` - removed the non-success response with the status `405` - added the optional property `subscription/allOf[subschema #2]/plan/charges/items/applied_pricing_unit` to the response with the `200` status - added the optional property `subscription/allOf[subschema #2]/plan/charges/items/filters/items/properties/pricing_group_keys` to the response with the `200` status - added the optional property `subscription/allOf[subschema #2]/plan/charges/items/properties/pricing_group_keys` to the response with the `200` status - added the optional property `subscription/allOf[subschema #2]/plan/entitlements` to the response with the `200` status - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/canceled_at` became required for the status `200` - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/current_billing_period_ending_at` became required for the status `200` - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/current_billing_period_started_at` became required for the status `200` - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/downgrade_plan_date` became required for the status `200` - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/ending_at` became required for the status `200` - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/name` became required for the status `200` - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/next_plan_code` became required for the status `200` - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/previous_plan_code` became required for the status `200` - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/started_at` became required for the status `200` - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/terminated_at` became required for the status `200` - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/trial_ended_at` became required for the status `200` - the response property `subscription/allOf[subschema #2]/plan/charges/items/filters` became required for the status `200` - the response property `subscription/allOf[subschema #2]/plan/charges/items/invoice_display_name` became required for the status `200` - the response property `subscription/allOf[subschema #2]/plan/charges/items/invoiceable` became required for the status `200` - the response property `subscription/allOf[subschema #2]/plan/charges/items/min_amount_cents` became required for the status `200` - the response property `subscription/allOf[subschema #2]/plan/charges/items/pay_in_advance` became required for the status `200` - the response property `subscription/allOf[subschema #2]/plan/charges/items/properties` became required for the status `200` - the response property `subscription/allOf[subschema #2]/plan/charges/items/prorated` became required for the status `200` - the response property `subscription/allOf[subschema #2]/plan/charges/items/regroup_paid_fees` became required for the status `200` - the response property `subscription/allOf[subschema #2]/plan/usage_thresholds/items/threshold_display_name` became required for the status `200` - response property `subscription/allOf[subschema #2]/plan/charges/items/filters/items/properties/grouped_by` deprecated - response property `subscription/allOf[subschema #2]/plan/charges/items/properties/grouped_by` deprecated - added the required property `subscription/allOf[#/components/schemas/SubscriptionObject]/on_termination_credit_note` to the response with the `200` status - added the required property `subscription/allOf[#/components/schemas/SubscriptionObject]/on_termination_invoice` to the response with the `200` status - **2025-06-09** `083d895c3f8e`: 3 info - response property `subscription/allOf[subschema #2]/plan/charges/items/taxes/items/applied_to_organization` deprecated - response property `subscription/allOf[subschema #2]/plan/minimum_commitment/taxes/items/applied_to_organization` deprecated - response property `subscription/allOf[subschema #2]/plan/taxes/items/applied_to_organization` deprecated - **2025-01-06** `e5683732fee1`: 1 breaking - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/ending_at` became nullable for the status `200` - **2024-12-22** `e1b7ed77904e`: 5 breaking, 9 warning - removed the required property `subscription/allOf[subschema #2]/plan/active_subscriptions_count` from the response with the `200` status - removed the required property `subscription/allOf[subschema #2]/plan/charges/items/taxes/items/customers_count` from the response with the `200` status - removed the required property `subscription/allOf[subschema #2]/plan/draft_invoices_count` from the response with the `200` status - removed the required property `subscription/allOf[subschema #2]/plan/minimum_commitment/taxes/items/customers_count` from the response with the `200` status - removed the required property `subscription/allOf[subschema #2]/plan/taxes/items/customers_count` from the response with the `200` status - removed the optional property `subscription/allOf[subschema #2]/plan/charges/items/taxes/items/add_ons_count` from the response with the `200` status - removed the optional property `subscription/allOf[subschema #2]/plan/charges/items/taxes/items/charges_count` from the response with the `200` status - removed the optional property `subscription/allOf[subschema #2]/plan/charges/items/taxes/items/plans_count` from the response with the `200` status - removed the optional property `subscription/allOf[subschema #2]/plan/minimum_commitment/taxes/items/add_ons_count` from the response with the `200` status - removed the optional property `subscription/allOf[subschema #2]/plan/minimum_commitment/taxes/items/charges_count` from the response with the `200` status - removed the optional property `subscription/allOf[subschema #2]/plan/minimum_commitment/taxes/items/plans_count` from the response with the `200` status - removed the optional property `subscription/allOf[subschema #2]/plan/taxes/items/add_ons_count` from the response with the `200` status - removed the optional property `subscription/allOf[subschema #2]/plan/taxes/items/charges_count` from the response with the `200` status - removed the optional property `subscription/allOf[subschema #2]/plan/taxes/items/plans_count` from the response with the `200` status - **2024-12-09** `d7f5a2be797e`: 3 breaking, 138 warning, 32 info - the `subscription/allOf[subschema #2]/plan/amount_currency` response's property type changed from no type to `string` for status `200` - the `subscription/allOf[subschema #2]/plan/charges/items/filters/items/properties` response's property type changed from no type to `object` for status `200` - the `subscription/allOf[subschema #2]/plan/charges/items/properties` response's property type changed from no type to `object` for status `200` - added the new `AED` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `AFN` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `ALL` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `AMD` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `ANG` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `AOA` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `ARS` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `AUD` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `AWG` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `AZN` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BAM` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BBD` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BDT` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BGN` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BIF` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BMD` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BND` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BOB` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BRL` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BSD` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BWP` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BYN` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `BZD` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `CAD` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `CDF` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `CHF` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `CLF` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `CLP` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `CNY` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `COP` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `CRC` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `CVE` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `CZK` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `DJF` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `DKK` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `DOP` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - added the new `DZD` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200` - …133 more --- [Operation](https://skmtc.dev/getlago/apis/lago-api-documentation/docs/subscriptions/:external_id/delete.md) - [API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) - [Page](https://skmtc.dev/getlago/apis/lago-api-documentation/changes/subscriptions/:external_id/delete)