--- title: "Changes to Get subscription (V2)" method: GET path: "/subscriptions/{id}/v2" --- # Changes to Get subscription (V2) `GET /subscriptions/{id}/v2` > Every recorded change to this operation, newest first. ## Timeline Changed in 39 of 139 revisions. - **2026-10-14** `3798546cc4a3`: 2 warning - **2026-10-12** `80eb0267435c`: 1 info - **2026-10-12** `de915dc839fe`: 1 warning - **2026-10-12** `e1ac9f73d09c`: 1 info - **2026-10-12** `9b1ab5a75b5e`: 1 warning - **2026-10-12** `d663503436ad`: 1 info - **2026-10-08** `477ea6131062`: 1 info - **2026-09-09** `ac5fdb062f59`: 1 info - **2026-09-08** `b83876bc3cb2`: 1 warning - **2026-09-08** `58f315d20550`: 1 info - **2026-09-01** `e1d4e27b5677`: 3 info - **2026-08-24** `9cd0dab91f5c`: 3 info - **2026-08-24** `66536658bde6`: 2 info - **2026-08-21** `d567e8585c2e`: 3 warning - **2026-08-21** `edf928b9b745`: 3 info - **2026-08-20** `562f13cf61dd`: 1 warning - **2026-07-31** `50b7421a9690`: 2 info - **2026-07-15** `f8ecf435d25d`: 7 warning, 5 info - **2026-07-09** `646d6658479b`: 3 info - **2026-07-09** `7d57386313c7`: 67 breaking, 131 warning, 70 info - **2026-07-09** `4b1a811c4179`: 146 breaking, 67 warning, 131 info - **2026-06-29** `7857ddc6e44d`: 1 warning, 2 info - **2026-06-24** `774ba8074d08`: 1 info - **2026-06-16** `257509e66883`: 6 info - **2026-06-12** `7084974acc30`: 1 info - **2026-06-10** `2a40f94de722`: 1 info - **2026-06-03** `7adf4f33ea1a`: 4 info - **2026-05-18** `8ec2edea6b20`: 4 warning - **2026-05-13** `7d5041d23ecb`: 1 info - **2026-05-13** `7934fabd26c1`: 2 warning - **2026-04-25** `5cfd03c5fc75`: 1 warning - **2026-04-23** `2ead4d5de7c1`: 2 warning, 2 info - **2026-04-22** `147c5358b6c7`: 1 info - **2026-04-10** `5856ed2fbdd6`: 5 warning, 2 info - **2026-04-06** `95af41a12111`: 6 warning, 9 info - **2026-04-04** `daf147b28b31`: 1 info - **2026-04-04** `33afc71210f5`: 1 warning - **2026-04-04** `3d452eb9ebcc`: 1 info - **2026-03-02** `8ab89ff34fdc`: 1 info ## Changes - **2026-10-14** `3798546cc4a3`: 2 warning - added the new `END_OF_MONTH` enum value to the `payment_terms` response property for the response status `200` - added the new `END_OF_NEXT_MONTH` enum value to the `payment_terms` response property for the response status `200` - **2026-10-12** `80eb0267435c`: 1 info - added the optional property `customer/contact_persons` to the response with the `200` status - **2026-10-12** `de915dc839fe`: 1 warning - removed the optional property `customer/contact_persons` from the response with the `200` status - **2026-10-12** `e1ac9f73d09c`: 1 info - added the optional property `customer/contact_persons` to the response with the `200` status - **2026-10-12** `9b1ab5a75b5e`: 1 warning - removed the optional property `customer/contact_persons` from the response with the `200` status - **2026-10-12** `d663503436ad`: 1 info - added the optional property `customer/contact_persons` to the response with the `200` status - **2026-10-08** `477ea6131062`: 1 info - added the optional property `customer/billing_currency` to the response with the `200` status - **2026-09-09** `ac5fdb062f59`: 1 info - added the optional property `line_item_grouping` to the response with the `200` status - **2026-09-08** `b83876bc3cb2`: 1 warning - removed the optional property `line_item_grouping` from the response with the `200` status - **2026-09-08** `58f315d20550`: 1 info - added the optional property `line_item_grouping` to the response with the `200` status - **2026-09-01** `e1d4e27b5677`: 3 info - added the optional property `coupon_associations/items/subscription_line_item/price/bucket_size` to the response with the `200` status - added the optional property `customer/tax_treatment` to the response with the `200` status - added the optional property `line_items/items/price/bucket_size` to the response with the `200` status - **2026-08-24** `9cd0dab91f5c`: 3 info - added the optional property `coupon_associations/items/subscription_line_item/price/plan/price_sync_status` to the response with the `200` status - added the optional property `line_items/items/price/plan/price_sync_status` to the response with the `200` status - added the optional property `plan/price_sync_status` to the response with the `200` status - **2026-08-24** `66536658bde6`: 2 info - added the optional property `coupon_associations/items/subscription_line_item/price/feature` to the response with the `200` status - added the optional property `line_items/items/price/feature` to the response with the `200` status - **2026-08-21** `d567e8585c2e`: 3 warning - removed the optional property `coupon_associations/items/subscription_line_item/price/plan/price_sync_status` from the response with the `200` status - removed the optional property `line_items/items/price/plan/price_sync_status` from the response with the `200` status - removed the optional property `plan/price_sync_status` from the response with the `200` status - **2026-08-21** `edf928b9b745`: 3 info - added the optional property `coupon_associations/items/subscription_line_item/price/plan/price_sync_status` to the response with the `200` status - added the optional property `line_items/items/price/plan/price_sync_status` to the response with the `200` status - added the optional property `plan/price_sync_status` to the response with the `200` status - **2026-08-20** `562f13cf61dd`: 1 warning - added the new `subscription_line_item` enum value to the `customer/integrations/items/entity_type` response property for the response status `200` - **2026-07-31** `50b7421a9690`: 2 info - added the optional property `coupon_associations/items/subscription_line_item/meter` to the response with the `200` status - added the optional property `line_items/items/meter` to the response with the `200` status - **2026-07-15** `f8ecf435d25d`: 7 warning, 5 info - added the new `ADDON` enum value to the `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/scope` response property for the response status `200` - added the new `ADDON` enum value to the `credit_grants/items/scope` response property for the response status `200` - added the new `ADDON` enum value to the `line_items/items/price/plan/credit_grants/items/scope` response property for the response status `200` - added the new `ADDON` enum value to the `plan/credit_grants/items/scope` response property for the response status `200` - added the new `invoice_line_item` enum value to the `customer/integrations/items/entity_type` response property for the response status `200` - added the new `not_implemented` enum value to the `code` response property for the response status `400` - added the new `not_implemented` enum value to the `code` response property for the response status `500` - added the optional property `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/addon_id` to the response with the `200` status - added the optional property `credit_grants/items/addon_id` to the response with the `200` status - added the optional property `customer/contact` to the response with the `200` status - added the optional property `line_items/items/price/plan/credit_grants/items/addon_id` to the response with the `200` status - added the optional property `plan/credit_grants/items/addon_id` to the response with the `200` status - **2026-07-09** `646d6658479b`: 3 info - the `billing_period_count` response's property default value `1` was removed for the status `200` - the `billing_period_count` response's property default value `1` was removed for the status `200` - the `billing_period_count` response's property default value `1` was removed for the status `200` - **2026-07-09** `7d57386313c7`: 67 breaking, 131 warning, 70 info - the `coupon_associations/items/coupon/status` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/status` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/commitment_time_buckets/items/` response's property type changed from no type to `object` for status `200` - the `coupon_associations/items/subscription_line_item/entity_type` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/invoice_cadence` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/price/entity_type` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/price/invoice_cadence` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/price/metadata` response's property type changed from no type to `object` for status `200` - the `coupon_associations/items/subscription_line_item/price/meter/aggregation` response's property type changed from no type to `object` for status `200` - the `coupon_associations/items/subscription_line_item/price/meter/filters/items/` response's property type changed from no type to `object` for status `200` - the `coupon_associations/items/subscription_line_item/price/meter/reset_usage` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/metadata` response's property type changed from no type to `object` for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/status` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/metadata` response's property type changed from no type to `object` for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/status` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/price/price_unit_tiers/items/` response's property type changed from no type to `object` for status `200` - the `coupon_associations/items/subscription_line_item/price/price_unit_type` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/price/pricing_unit/metadata` response's property type changed from no type to `object` for status `200` - the `coupon_associations/items/subscription_line_item/price/pricing_unit/status` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/price/status` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/price/tiers/items/` response's property type changed from no type to `object` for status `200` - the `coupon_associations/items/subscription_line_item/price/transform_quantity` response's property type changed from no type to `object` for status `200` - the `coupon_associations/items/subscription_line_item/price/type` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/price_type` response's property type changed from no type to `string` for status `200` - the `coupon_associations/items/subscription_line_item/status` response's property type changed from no type to `string` for status `200` - the `credit_grants/items/metadata` response's property type changed from no type to `object` for status `200` - the `credit_grants/items/status` response's property type changed from no type to `string` for status `200` - the `customer/integrations/items/entity_type` response's property type changed from no type to `string` for status `200` - the `customer/integrations/items/status` response's property type changed from no type to `string` for status `200` - the `customer/status` response's property type changed from no type to `string` for status `200` - the `line_items/items/commitment_time_buckets/items/` response's property type changed from no type to `object` for status `200` - the `line_items/items/entity_type` response's property type changed from no type to `string` for status `200` - the `line_items/items/invoice_cadence` response's property type changed from no type to `string` for status `200` - the `line_items/items/price/entity_type` response's property type changed from no type to `string` for status `200` - the `line_items/items/price/invoice_cadence` response's property type changed from no type to `string` for status `200` - the `line_items/items/price/metadata` response's property type changed from no type to `object` for status `200` - the `line_items/items/price/meter/aggregation` response's property type changed from no type to `object` for status `200` - the `line_items/items/price/meter/filters/items/` response's property type changed from no type to `object` for status `200` - the `line_items/items/price/meter/reset_usage` response's property type changed from no type to `string` for status `200` - the `line_items/items/price/plan/credit_grants/items/metadata` response's property type changed from no type to `object` for status `200` - …228 more - **2026-07-09** `4b1a811c4179`: 146 breaking, 67 warning, 131 info - the `billing_anchor` response's property format changed from `date-time` to no format for status `200` - the `cancel_at` response's property format changed from `date-time` to no format for status `200` - the `cancelled_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/coupon/created_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/coupon/status` response's property type changed from `string` to no type for status `200` - the `coupon_associations/items/coupon/updated_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/created_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/end_date` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/start_date` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/status` response's property type changed from `string` to no type for status `200` - the `coupon_associations/items/subscription_line_item/commitment_time_buckets/items/` response's property type changed from `object` to no type for status `200` - the `coupon_associations/items/subscription_line_item/created_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/end_date` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/entity_type` response's property type changed from `string` to no type for status `200` - the `coupon_associations/items/subscription_line_item/invoice_cadence` response's property type changed from `string` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/created_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/end_date` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/entity_type` response's property type changed from `string` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/group/created_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/group/updated_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/invoice_cadence` response's property type changed from `string` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/metadata` response's property type changed from `object` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/meter/aggregation` response's property type changed from `object` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/meter/created_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/meter/filters/items/` response's property type changed from `object` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/meter/reset_usage` response's property type changed from `string` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/meter/updated_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/created_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/created_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/credit_grant_anchor` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/end_date` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/metadata` response's property type changed from `object` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/start_date` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/status` response's property type changed from `string` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/updated_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/metadata` response's property type changed from `object` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/status` response's property type changed from `string` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/plan/updated_at` response's property format changed from `date-time` to no format for status `200` - the `coupon_associations/items/subscription_line_item/price/price_unit_tiers/items/` response's property type changed from `object` to no type for status `200` - the `coupon_associations/items/subscription_line_item/price/price_unit_type` response's property type changed from `string` to no type for status `200` - …304 more - **2026-06-29** `7857ddc6e44d`: 1 warning, 2 info - removed the optional property `customer_timezone` from the response with the `200` status - added the optional property `customer/timezone` to the response with the `200` status - added the optional property `timezone` to the response with the `200` status - **2026-06-24** `774ba8074d08`: 1 info - added the optional property `coupon_associations/items/subscription_line_item` to the response with the `200` status - **2026-06-16** `257509e66883`: 6 info - added the optional property `line_items/items/commitment_time_buckets/items/commitment_type` to the response with the `200` status - added the optional property `line_items/items/commitment_time_buckets/items/commitment_value` to the response with the `200` status - added the optional property `line_items/items/commitment_time_buckets/items/id` to the response with the `200` status - added the optional property `line_items/items/commitment_time_buckets/items/overage_factor` to the response with the `200` status - added the optional property `line_items/items/commitment_time_buckets/items/price_id` to the response with the `200` status - added the optional property `line_items/items/commitment_time_buckets/items/true_up_enabled` to the response with the `200` status - **2026-06-12** `7084974acc30`: 1 info - added the optional property `coupon_associations/items/coupon/coupon_code` to the response with the `200` status - **2026-06-10** `2a40f94de722`: 1 info - added the optional property `line_items/items/commitment_time_buckets` to the response with the `200` status - **2026-06-03** `7adf4f33ea1a`: 4 info - added the optional property `customer/integrations/items/metadata` to the response with the `200` status - added the optional property `line_items/items/price/sequence` to the response with the `200` status - added the optional property `plan_prices_out_of_sync` to the response with the `200` status - added the optional property `synced_price_sequence` to the response with the `200` status - **2026-05-18** `8ec2edea6b20`: 4 warning - removed the optional property `details` from the response with the `400` status - removed the optional property `details` from the response with the `500` status - added the new `too_many_requests` enum value to the `code` response property for the response status `400` - added the new `too_many_requests` enum value to the `code` response property for the response status `500` - **2026-05-13** `7d5041d23ecb`: 1 info - added the optional property `auto_invoice_threshold` to the response with the `200` status - **2026-05-13** `7934fabd26c1`: 2 warning - added the new `delegated_invoicing` enum value to the `subscription_type` response property for the response status `200` - added the new `grouped_invoicing` enum value to the `subscription_type` response property for the response status `200` - **2026-04-25** `5cfd03c5fc75`: 1 warning - removed the optional property `line_items/items/trial_period_days` from the response with the `200` status - **2026-04-23** `2ead4d5de7c1`: 2 warning, 2 info - removed the optional property `line_items/items/price/trial_period` from the response with the `200` status - removed the optional property `line_items/items/trial_period` from the response with the `200` status - added the optional property `line_items/items/price/trial_period_days` to the response with the `200` status - added the optional property `line_items/items/trial_period_days` to the response with the `200` status - **2026-04-22** `147c5358b6c7`: 1 info - added the optional property `line_items/items/addon_association_id` to the response with the `200` status - **2026-04-10** `5856ed2fbdd6`: 5 warning, 2 info - added the new `ONETIME` enum value to the `billing_period` response property for the response status `200` - added the new `ONETIME` enum value to the `commitment_duration` response property for the response status `200` - added the new `ONETIME` enum value to the `line_items/items/billing_period` response property for the response status `200` - added the new `ONETIME` enum value to the `line_items/items/commitment_duration` response property for the response status `200` - added the new `ONETIME` enum value to the `line_items/items/price/billing_period` response property for the response status `200` - removed the `ONETIME` enum value from the `billing_cadence` response property for the response status `200` - removed the `ONETIME` enum value from the `line_items/items/price/billing_cadence` response property for the response status `200` - **2026-04-06** `95af41a12111`: 6 warning, 9 info - removed the optional property `customer/parent_customer` from the response with the `200` status - removed the optional property `customer/parent_customer_id` from the response with the `200` status - removed the optional property `error` from the response with the `400` status - removed the optional property `error` from the response with the `500` status - removed the optional property `success` from the response with the `400` status - removed the optional property `success` from the response with the `500` status - added the optional property `code` to the response with the `400` status - added the optional property `code` to the response with the `500` status - added the optional property `details` to the response with the `400` status - added the optional property `details` to the response with the `500` status - added the optional property `http_status_code` to the response with the `400` status - added the optional property `http_status_code` to the response with the `500` status - added the optional property `message` to the response with the `400` status - added the optional property `message` to the response with the `500` status - added the optional property `subscription_type` to the response with the `200` status - **2026-04-04** `daf147b28b31`: 1 info - added the optional property `coupon_associations/items/coupon` to the response with the `200` status - **2026-04-04** `33afc71210f5`: 1 warning - removed the optional property `coupon_associations/items/coupon` from the response with the `200` status - **2026-04-04** `3d452eb9ebcc`: 1 info - added the optional property `customer/integrations` to the response with the `200` status - **2026-03-02** `8ab89ff34fdc`: 1 info - added the optional property `line_items/items/price/meter/aggregation/expression` to the response with the `200` status --- [Operation](https://skmtc.dev/flexprice/apis/flexprice-api/docs/subscriptions/:id/v2/get.md) - [API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [Page](https://skmtc.dev/flexprice/apis/flexprice-api/changes/subscriptions/:id/v2/get)