---
title: "Changes to Retrieve a user's billing subscription"
method: GET
path: "/users/{user_id}/billing/subscription"
---

# Changes to Retrieve a user's billing subscription

`GET /users/{user_id}/billing/subscription`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 49 revisions.

- **2026-07-30** (2025-11-10) `1d47a6af3bef`: 1 warning
- **2026-06-26** (2025-11-10) `b45c56a4eed9`: 4 info
- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 6 info
- **2026-05-01** (2025-11-10) `688cb65fb0a6`: 1 info
- **2026-03-19** (2025-11-10) `b1a5498e4465`: 6 breaking, 1 info
- **2026-03-06** (2025-11-10) `42e3e85e75f8`: 4 info
- **2026-02-12** (2025-11-10) `33ad373c8b42`: 1 info
- **2026-01-09** (2025-11-10) `b8334b5a56cf`: 1 info
- **2025-12-11** (2025-11-10) `569a9fe6f427`: 2 breaking
- **2025-11-11** (2025-11-10) `765c093d987e`: 1 info

## Changes

- **2026-07-30** (2025-11-10) `1d47a6af3bef`: 1 warning
  - added the new `payer-credits` enum value to the `subscription_items/items/payment_method/payment_type` response property for the response status `200`
- **2026-06-26** (2025-11-10) `b45c56a4eed9`: 4 info
  - added `#/components/schemas/CommerceTotalsResponse-2` to the `next_payment/totals` response property `allOf` list for the response status `200`
  - added `#/components/schemas/CommerceTotalsResponse-2` to the `subscription_items/items/totals` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/schemas-CommerceTotalsResponse` from the `next_payment/totals` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/schemas-CommerceTotalsResponse` from the `subscription_items/items/totals` response property `allOf` list for the response status `200`
- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 6 info
  - added the optional property `next_payment/per_unit_totals` to the response with the `200` status
  - added the optional property `next_payment/totals` to the response with the `200` status
  - added the optional property `subscription_items/items/next_payment/allOf[#/components/schemas/CommerceSubscriptionItemNextPaymentResponse]/per_unit_totals` to the response with the `200` status
  - added the optional property `subscription_items/items/next_payment/allOf[#/components/schemas/CommerceSubscriptionItemNextPaymentResponse]/totals` to the response with the `200` status
  - added `#/components/schemas/schemas-CommerceTotalsResponse` to the `subscription_items/items/totals` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/CommerceTotalsResponse` from the `subscription_items/items/totals` response property `allOf` list for the response status `200`
- **2026-05-01** (2025-11-10) `688cb65fb0a6`: 1 info
  - added the optional property `subscription_items/items/seats/allOf[#/components/schemas/CommerceSubscriptionItemSeatsResponse]/tiers` to the response with the `200` status
- **2026-03-19** (2025-11-10) `b1a5498e4465`: 6 breaking, 1 info
  - the response property `subscription_items/items/plan/allOf[#/components/schemas/CommercePlan]/fee` became nullable for the status `200`
  - the `subscription_items/items/plan/allOf[#/components/schemas/CommercePlan]/fee` response's property type changed from `object` to no type for status `200`
  - removed the required property `subscription_items/items/plan/allOf[#/components/schemas/CommercePlan]/fee/amount` from the response with the `200` status
  - removed the required property `subscription_items/items/plan/allOf[#/components/schemas/CommercePlan]/fee/amount_formatted` from the response with the `200` status
  - removed the required property `subscription_items/items/plan/allOf[#/components/schemas/CommercePlan]/fee/currency` from the response with the `200` status
  - removed the required property `subscription_items/items/plan/allOf[#/components/schemas/CommercePlan]/fee/currency_symbol` from the response with the `200` status
  - added `#/components/schemas/CommerceMoneyResponse` to the `subscription_items/items/plan/allOf[#/components/schemas/CommercePlan]/fee` response property `allOf` list for the response status `200`
- **2026-03-06** (2025-11-10) `42e3e85e75f8`: 4 info
  - added the optional property `subscription_items/items/credits` to the response with the `200` status
  - added the optional property `subscription_items/items/plan/allOf[#/components/schemas/CommercePlan]/unit_prices` to the response with the `200` status
  - added the optional property `subscription_items/items/seats` to the response with the `200` status
  - added the optional property `subscription_items/items/totals` to the response with the `200` status
- **2026-02-12** (2025-11-10) `33ad373c8b42`: 1 info
  - added the optional property `subscription_items/items/payer/credits_balance` to the response with the `200` status
- **2026-01-09** (2025-11-10) `b8334b5a56cf`: 1 info
  - added the optional property `subscription_items/items/price_id` to the response with the `200` status
- **2025-12-11** (2025-11-10) `569a9fe6f427`: 2 breaking
  - the response property `subscription_items/items/plan/allOf[#/components/schemas/CommercePlan]/features/items/avatar_url` became nullable for the status `200`
  - the response property `subscription_items/items/plan/allOf[#/components/schemas/CommercePlan]/features/items/description` became nullable for the status `200`
- **2025-11-11** (2025-11-10) `765c093d987e`: 1 info
  - response property `subscription_items/items/plan/allOf[#/components/schemas/CommercePlan]/product_id` deprecated

---

[Operation](https://skmtc.dev/clerk/apis/clerk-backend-api/docs/users/:user_id/billing/subscription/get.md) - [API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [Page](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/users/:user_id/billing/subscription/get)