--- title: "Changes to List subscriptions" method: GET path: "/api/v1/subscriptions" --- # Changes to List subscriptions `GET /api/v1/subscriptions` > Every recorded change to this operation, newest first. ## Timeline Changed in 15 of 54 revisions. - **2026-03-31** (v1) `560215310a09`: 1 breaking, 2 info - **2026-03-30** (v1) `5cb340234766`: 1 info - **2026-03-27** (v1) `de35c02bb0d2`: 2 breaking, 2 warning, 1 info - **2026-02-05** (v1) `f9c417ec1ed4`: 1 info - **2026-01-21** (v1) `9fba45d198be`: 2 info - **2026-01-20** (v1) `665f680338b5`: 2 info - **2025-12-17** (v1) `2244ec0dabe3`: 2 breaking, 1 warning, 15 info - **2025-12-02** (v1) `f3aab0fcd63f`: 1 warning, 1 info - **2025-10-16** (v1) `a174f46ee4f8`: 2 info - **2025-10-15** (v1) `19630d3533e5`: 1 info - **2025-10-14** (v1) `532c5edf3ddd`: 1 breaking, 3 info - **2025-10-14** (v1) `da72c03d9734`: 1 info - **2025-07-22** (v1) `f9622bc2c669`: 4 breaking, 161 warning, 9 info - **2025-07-13** (v1) `95e4503a32c3`: 2 info - **2025-07-09** (v1) `dece17f86f99`: 18 breaking, 15 warning, 165 info ## Changes - **2026-03-31** (v1) `560215310a09`: 1 breaking, 2 info - added `#/components/schemas/OnlinePaymentMethodConfig, #/components/schemas/BankTransferPaymentMethodConfig, #/components/schemas/ExternalPaymentMethodConfig` to the `data/items/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property `oneOf` list for the response status `200` - added discriminator to `data/items/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property for the response status `200` - removed `subschema #1, subschema #2, subschema #3` from the `data/items/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property `oneOf` list for the response status `200` - **2026-03-30** (v1) `5cb340234766`: 1 info - added the new optional `query` request parameter `order_by` - **2026-03-27** (v1) `de35c02bb0d2`: 2 breaking, 2 warning, 1 info - added `#/components/schemas/BankAccountId, subschema #1` to the `data/items/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` response property `oneOf` list for the response status `200` - the `data/items/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` response's property type changed from `string, null` to no type for status `200` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `401` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `500` - added the non-success response with the status `429` - **2026-02-05** (v1) `f9c417ec1ed4`: 1 info - added the optional property `data/items/payment_methods_config` to the response with the `200` status - **2026-01-21** (v1) `9fba45d198be`: 2 info - api tag `Subscriptions` added - api tag `Subscription` removed - **2026-01-20** (v1) `665f680338b5`: 2 info - api tag `Subscription` added - api tag `subscription` removed - **2025-12-17** (v1) `2244ec0dabe3`: 2 breaking, 1 warning, 15 info - for the `query` request parameter `page`, the format changed from no format to `int32` - for the `query` request parameter `per_page`, the format changed from no format to `int32` - deleted the `query` request parameter `status` - added the new optional `query` request parameter `statuses` - the `query` request parameter `page` became optional - the `query` request parameter `per_page` became optional - for the `query` request parameter `customer_id`, the format was generalized from `MeteroidId` to no format - added the optional property `data/items/activated_at` to the response with the `200` status - added the optional property `data/items/billing_start_date` to the response with the `200` status - added the optional property `data/items/end_date` to the response with the `200` status - added the optional property `data/items/invoice_memo` to the response with the `200` status - added the optional property `data/items/plan_description` to the response with the `200` status - added the optional property `data/items/trial_duration` to the response with the `200` status - added the required property `data/items/created_at` to the response with the `200` status - added the required property `data/items/mrr_cents` to the response with the `200` status - added the required property `data/items/net_terms` to the response with the `200` status - added the required property `data/items/period` to the response with the `200` status - added the required property `data/items/start_date` to the response with the `200` status - **2025-12-02** (v1) `f3aab0fcd63f`: 1 warning, 1 info - added the new `ERRORED` enum value to the `data/items/status` response property for the response status `200` - added the enum value `ERRORED` to the property `items/` of the `query` request parameter `status` - **2025-10-16** (v1) `a174f46ee4f8`: 2 info - added the required property `data/items/auto_advance_invoices` to the response with the `200` status - added the required property `data/items/charge_automatically` to the response with the `200` status - **2025-10-15** (v1) `19630d3533e5`: 1 info - added the new optional `query` request parameter `status` - **2025-10-14** (v1) `532c5edf3ddd`: 1 breaking, 3 info - removed the required property `total` from the response with the `200` status - the `query` request parameter `customer_id` became optional - the `query` request parameter `plan_id` became optional - added the required property `pagination_meta` to the response with the `200` status - **2025-10-14** (v1) `da72c03d9734`: 1 info - added the optional property `data/items/purchase_order` to the response with the `200` status - **2025-07-22** (v1) `f9622bc2c669`: 4 breaking, 161 warning, 9 info - added the new required `query` request parameter `customer_id` - added the new required `query` request parameter `page` - added the new required `query` request parameter `per_page` - added the new required `query` request parameter `plan_id` - deleted the `query` request parameter `limit` - deleted the `query` request parameter `offset` - added the new `AED` enum value to the `data/items/currency` response property for the response status `200` - added the new `AFN` enum value to the `data/items/currency` response property for the response status `200` - added the new `ALL` enum value to the `data/items/currency` response property for the response status `200` - added the new `AMD` enum value to the `data/items/currency` response property for the response status `200` - added the new `ANG` enum value to the `data/items/currency` response property for the response status `200` - added the new `AOA` enum value to the `data/items/currency` response property for the response status `200` - added the new `ARS` enum value to the `data/items/currency` response property for the response status `200` - added the new `AUD` enum value to the `data/items/currency` response property for the response status `200` - added the new `AWG` enum value to the `data/items/currency` response property for the response status `200` - added the new `AZN` enum value to the `data/items/currency` response property for the response status `200` - added the new `BAM` enum value to the `data/items/currency` response property for the response status `200` - added the new `BBD` enum value to the `data/items/currency` response property for the response status `200` - added the new `BDT` enum value to the `data/items/currency` response property for the response status `200` - added the new `BGN` enum value to the `data/items/currency` response property for the response status `200` - added the new `BHD` enum value to the `data/items/currency` response property for the response status `200` - added the new `BIF` enum value to the `data/items/currency` response property for the response status `200` - added the new `BMD` enum value to the `data/items/currency` response property for the response status `200` - added the new `BND` enum value to the `data/items/currency` response property for the response status `200` - added the new `BOB` enum value to the `data/items/currency` response property for the response status `200` - added the new `BRL` enum value to the `data/items/currency` response property for the response status `200` - added the new `BSD` enum value to the `data/items/currency` response property for the response status `200` - added the new `BTN` enum value to the `data/items/currency` response property for the response status `200` - added the new `BWP` enum value to the `data/items/currency` response property for the response status `200` - added the new `BYN` enum value to the `data/items/currency` response property for the response status `200` - added the new `BZD` enum value to the `data/items/currency` response property for the response status `200` - added the new `CAD` enum value to the `data/items/currency` response property for the response status `200` - added the new `CDF` enum value to the `data/items/currency` response property for the response status `200` - added the new `CHF` enum value to the `data/items/currency` response property for the response status `200` - added the new `CLP` enum value to the `data/items/currency` response property for the response status `200` - added the new `CNH` enum value to the `data/items/currency` response property for the response status `200` - added the new `CNY` enum value to the `data/items/currency` response property for the response status `200` - added the new `COP` enum value to the `data/items/currency` response property for the response status `200` - added the new `CRC` enum value to the `data/items/currency` response property for the response status `200` - added the new `CUC` enum value to the `data/items/currency` response property for the response status `200` - …134 more - **2025-07-13** (v1) `95e4503a32c3`: 2 info - the endpoint scheme security `bearer_auth` was added to the API - the endpoint scheme security `api-key` was removed from the API - **2025-07-09** (v1) `dece17f86f99`: 18 breaking, 15 warning, 165 info - added the new required `query` request parameter `limit` - added the new required `query` request parameter `offset` - removed the media type `application/json` for the response with the status `401` - removed the media type `application/json` for the response with the status `500` - removed the required property `data/items/auto_advance_invoices` from the response with the `200` status - removed the required property `data/items/charge_automatically` from the response with the `200` status - removed the required property `data/items/created_at` from the response with the `200` status - removed the required property `data/items/current_period_start` from the response with the `200` status - removed the required property `data/items/mrr_cents` from the response with the `200` status - removed the required property `data/items/net_terms` from the response with the `200` status - removed the required property `data/items/period` from the response with the `200` status - removed the required property `data/items/plan_id` from the response with the `200` status - removed the required property `data/items/plan_name` from the response with the `200` status - removed the required property `data/items/plan_version` from the response with the `200` status - removed the required property `data/items/plan_version_id` from the response with the `200` status - removed the required property `data/items/start_date` from the response with the `200` status - removed the required property `data/items/status` from the response with the `200` status - removed the required property `pagination_meta` from the response with the `200` status - deleted the `query` request parameter `customer_id` - deleted the `query` request parameter `order_by` - deleted the `query` request parameter `page` - deleted the `query` request parameter `per_page` - deleted the `query` request parameter `plan_id` - deleted the `query` request parameter `statuses` - removed the optional property `data/items/activated_at` from the response with the `200` status - removed the optional property `data/items/billing_start_date` from the response with the `200` status - removed the optional property `data/items/current_period_end` from the response with the `200` status - removed the optional property `data/items/end_date` from the response with the `200` status - removed the optional property `data/items/invoice_memo` from the response with the `200` status - removed the optional property `data/items/payment_methods_config` from the response with the `200` status - removed the optional property `data/items/plan_description` from the response with the `200` status - removed the optional property `data/items/purchase_order` from the response with the `200` status - removed the optional property `data/items/trial_duration` from the response with the `200` status - the endpoint scheme security `api-key` was added to the API - the endpoint scheme security `bearer_auth` was removed from the API - api tag `subscription` added - api tag `Subscriptions` removed - removed the non-success response with the status `429` - removed the `AED` enum value from the `data/items/currency` response property for the response status `200` - removed the `AFN` enum value from the `data/items/currency` response property for the response status `200` - …158 more --- [Operation](https://skmtc.dev/meteroid-oss/apis/meteroid/docs/api/v1/subscriptions/get.md) - [API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) - [Page](https://skmtc.dev/meteroid-oss/apis/meteroid/changes/api/v1/subscriptions/get)