---
title: "Changes to Retrieve a subscription"
method: GET
path: "/subscriptions/{external_id}"
---

# Changes to Retrieve a subscription

`GET /subscriptions/{external_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-11-03** `5d26657495a3`: 6 breaking, 5 warning, 26 info

## Changes

- **2026-11-03** `5d26657495a3`: 6 breaking, 5 warning, 26 info
  - the response property `subscription/allOf[subschema #2]/plan/description` became nullable for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/fixed_charges/items/invoice_display_name` became nullable for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/invoice_display_name` became nullable for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/minimum_commitment/invoice_display_name` became nullable for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/trial_period` became nullable for the status `200`
  - the `subscription/allOf[subschema #2]/plan/fixed_charges/items/units` response's property type changed from `number` to `string` for status `200`
  - added the new `SYP` enum value to the `subscription/allOf[#/components/schemas/SubscriptionObject]/plan_amount_currency` response property for the response status `200`
  - added the new `SYP` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200`
  - added the new `TND` enum value to the `subscription/allOf[#/components/schemas/SubscriptionObject]/plan_amount_currency` response property for the response status `200`
  - added the new `TND` enum value to the `subscription/allOf[subschema #2]/plan/amount_currency` response property for the response status `200`
  - added the new `manual` enum value to the `subscription/allOf[#/components/schemas/SubscriptionObject]/cancellation_reason` response property for the response status `200`
  - added the new enum value `incomplete` to the `query` request parameter `status`
  - added the optional property `authorization` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/entitlements` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/applicable_usage_thresholds` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/charges/items/filters/items/charge_code` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/charges/items/filters/items/lago_id` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/charges/items/taxes/items/applied_to_billing_entities_codes` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/fixed_charges/items/taxes/items/applied_to_billing_entities_codes` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/minimum_commitment/taxes/items/applied_to_billing_entities_codes` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/parent_id` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/pending_deletion` to the response with the `200` status
  - added the optional property `subscription/allOf[subschema #2]/plan/taxes/items/applied_to_billing_entities_codes` to the response with the `200` status
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/activated_at` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/activation_rules` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/activation_rules/items/expires_at` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/cancellation_reason` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/consolidate_invoice` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/payment_method` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/plan_amount_cents` became required for the status `200`
  - the response property `subscription/allOf[#/components/schemas/SubscriptionObject]/plan_amount_currency` became required for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/charges/items/taxes/items/description` became required for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/fixed_charges/items/taxes/items/description` became required for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/minimum_commitment/taxes/items/description` became required for the status `200`
  - the response property `subscription/allOf[subschema #2]/plan/taxes/items/description` became required for the status `200`
  - added the required property `subscription/allOf[#/components/schemas/SubscriptionObject]/progressive_billing_disabled` to the response with the `200` status
  - added the required property `subscription/allOf[#/components/schemas/SubscriptionObject]/purchase_order_number` to the response with the `200` status

---

[Operation](https://skmtc.dev/getlago/apis/lago-api-documentation/docs/subscriptions/:external_id/get.md) - [API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) - [Page](https://skmtc.dev/getlago/apis/lago-api-documentation/changes/subscriptions/:external_id/get)