---
title: "Changes to Extend free trial for a subscription item"
method: POST
path: "/billing/subscription_items/{subscription_item_id}/extend_free_trial"
---

# Changes to Extend free trial for a subscription item

`POST /billing/subscription_items/{subscription_item_id}/extend_free_trial`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 49 revisions.

- **2026-06-26** (2025-11-10) `b45c56a4eed9`: 4 info
- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 4 info
- **2026-03-19** (2025-11-10) `b1a5498e4465`: 18 breaking, 3 info
- **2026-02-12** (2025-11-10) `33ad373c8b42`: 1 info
- **2026-01-09** (2025-11-10) `b8334b5a56cf`: 1 info

## Changes

- **2026-06-26** (2025-11-10) `b45c56a4eed9`: 4 info
  - added `#/components/schemas/CommercePayerResponse-2` to the `payer` response property `allOf` list for the response status `200`
  - added `#/components/schemas/CommercePlan-2` to the `plan` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/schemas-CommercePayerResponse` from the `payer` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/schemas-CommercePlan` from the `plan` response property `allOf` list for the response status `200`
- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 4 info
  - added the optional property `next_invoice/allOf[#/components/schemas/CommerceSubscriptionItemNextPaymentResponse]/per_unit_totals` to the response with the `200` status
  - added the optional property `next_invoice/allOf[#/components/schemas/CommerceSubscriptionItemNextPaymentResponse]/totals` to the response with the `200` status
  - added the optional property `next_payment/allOf[#/components/schemas/CommerceSubscriptionItemNextPaymentResponse]/per_unit_totals` to the response with the `200` status
  - added the optional property `next_payment/allOf[#/components/schemas/CommerceSubscriptionItemNextPaymentResponse]/totals` to the response with the `200` status
- **2026-03-19** (2025-11-10) `b1a5498e4465`: 18 breaking, 3 info
  - the response property `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee` became nullable for the status `200`
  - the response property `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee` became nullable for the status `200`
  - the response property `plan/allOf[#/components/schemas/schemas-CommercePlan]/fee` became nullable for the status `200`
  - the `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee` response's property type changed from `object` to no type for status `200`
  - the `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee` response's property type changed from `object` to no type for status `200`
  - the `plan/allOf[#/components/schemas/schemas-CommercePlan]/fee` response's property type changed from `object` to no type for status `200`
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee/amount` from the response with the `200` status
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee/amount_formatted` from the response with the `200` status
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee/currency` from the response with the `200` status
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee/currency_symbol` from the response with the `200` status
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee/amount` from the response with the `200` status
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee/amount_formatted` from the response with the `200` status
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee/currency` from the response with the `200` status
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee/currency_symbol` from the response with the `200` status
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/fee/amount` from the response with the `200` status
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/fee/amount_formatted` from the response with the `200` status
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/fee/currency` from the response with the `200` status
  - removed the required property `plan/allOf[#/components/schemas/schemas-CommercePlan]/fee/currency_symbol` from the response with the `200` status
  - added `#/components/schemas/CommerceMoneyResponse` to the `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee` response property `allOf` list for the response status `200`
  - added `#/components/schemas/CommerceMoneyResponse` to the `plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee` response property `allOf` list for the response status `200`
  - added `#/components/schemas/CommerceMoneyResponse` to the `plan/allOf[#/components/schemas/schemas-CommercePlan]/fee` response property `allOf` list for the response status `200`
- **2026-02-12** (2025-11-10) `33ad373c8b42`: 1 info
  - added the optional property `payer/allOf[#/components/schemas/schemas-CommercePayerResponse]/credits_balance` to the response with the `200` status
- **2026-01-09** (2025-11-10) `b8334b5a56cf`: 1 info
  - added the optional property `price_id` to the response with the `200` status

---

[Operation](https://skmtc.dev/clerk/apis/clerk-backend-api/docs/billing/subscription_items/:subscription_item_id/extend_free_trial/post.md) - [API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [Page](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/billing/subscription_items/:subscription_item_id/extend_free_trial/post)