---
title: "Changes to Get User Subscription Info"
method: GET
path: "/v1/user/subscription"
---

# Changes to Get User Subscription Info

`GET /v1/user/subscription`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 108 revisions.

- **2026-10-02** `f94fa2aa9384`: 1 info
- **2026-09-15** `b054999f0d0f`: 2 warning
- **2026-08-27** `f366bca2ae3c`: 1 warning, 1 info
- **2026-08-22** `b96b80bcbb83`: 1 warning
- **2026-07-13** `009bd651509a`: 1 info
- **2026-06-08** `37fac3c5a2d7`: 4 info
- **2026-04-03** `deb5e58ddddf`: 3 info
- **2026-02-08** `5b595807512c`: 2 warning, 16 info
- **2025-05-16** `503db4198a44`: 14 breaking, 12 info
- **2024-05-07** `c1dd2ce19be9`: 2 info
- **2023-08-12** `922ab0d49146`: 2 info

## Changes

- **2026-10-02** `f94fa2aa9384`: 1 info
  - added the optional property `is_eligible_for_starter_promo` to the response with the `200` status
- **2026-09-15** `b054999f0d0f`: 2 warning
  - added the new `gbp` enum value to the `currency/anyOf[subschema #1: Currency]/` response property for the response status `200`
  - added the new `gbp` enum value to the `current_overage/currency` response property for the response status `200`
- **2026-08-27** `f366bca2ae3c`: 1 warning, 1 info
  - added the new `grant` enum value to the `pending_change/anyOf[subschema #1: PendingSubscriptionSwitchResponseModel]/next_tier` response property for the response status `200`
  - the `current_overage/amount` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was added for the status `200`
- **2026-08-22** `b96b80bcbb83`: 1 warning
  - added the new `go` enum value to the `pending_change/anyOf[subschema #1: PendingSubscriptionSwitchResponseModel]/next_tier` response property for the response status `200`
- **2026-07-13** `009bd651509a`: 1 info
  - added the required property `professional_voice_slots_used_in_workspace` to the response with the `200` status
- **2026-06-08** `37fac3c5a2d7`: 4 info
  - added `#/components/schemas/Currency` to the `currency` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `currency` response property `anyOf` list for the response status `200`
  - added the required property `current_overage` to the response with the `200` status
  - added the required property `max_credit_limit_extension` to the response with the `200` status
- **2026-04-03** `deb5e58ddddf`: 3 info
  - api tag `user` removed
  - added the optional property `has_used_creator_coupon_on_account` to the response with the `200` status
  - added the optional property `has_used_starter_coupon_on_account` to the response with the `200` status
- **2026-02-08** `5b595807512c`: 2 warning, 16 info
  - added the new `free_disabled` enum value to the `status` response property for the response status `200`
  - added the new `inr` enum value to the `currency/anyOf[subschema #1]/` response property for the response status `200`
  - api operation id `Get_user_subscription_info_v1_user_subscription_get` removed and replaced with `get_user_subscription_info`
  - added the optional property `next_invoice/anyOf[subschema #1: InvoiceResponseModel]/discount_amount_off` to the response with the `200` status
  - added the optional property `next_invoice/anyOf[subschema #1: InvoiceResponseModel]/subtotal_cents` to the response with the `200` status
  - added the optional property `next_invoice/anyOf[subschema #1: InvoiceResponseModel]/tax_cents` to the response with the `200` status
  - added the optional property `pending_change` to the response with the `200` status
  - added `#/components/schemas/BillingPeriod` to the `billing_period` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/CharacterRefreshPeriod` to the `character_refresh_period` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `billing_period` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `character_refresh_period` response property `anyOf` list for the response status `200`
  - removed the `canceled` enum value from the `status` response property for the response status `200`
  - removed the `incomplete_expired` enum value from the `status` response property for the response status `200`
  - removed the `unpaid` enum value from the `status` response property for the response status `200`
  - added the required property `next_invoice/anyOf[subschema #1: InvoiceResponseModel]/discounts` to the response with the `200` status
  - added the required property `next_invoice/anyOf[subschema #1: InvoiceResponseModel]/payment_intent_status` to the response with the `200` status
  - added the required property `next_invoice/anyOf[subschema #1: InvoiceResponseModel]/payment_intent_statusses` to the response with the `200` status
  - added the required property `open_invoices` to the response with the `200` status
- **2025-05-16** `503db4198a44`: 14 breaking, 12 info
  - the response property `billing_period` became optional for the status `200`
  - the response property `character_refresh_period` became optional for the status `200`
  - the response property `currency` became optional for the status `200`
  - the response property `max_voice_add_edits` became optional for the status `200`
  - the response property `next_character_count_reset_unix` became optional for the status `200`
  - the response property `next_invoice` became optional for the status `200`
  - response property `billing_period` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `character_refresh_period` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `currency` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `max_voice_add_edits` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `next_character_count_reset_unix` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `next_invoice` response's property type changed from `object` to no type for status `200`
  - removed the required property `next_invoice/amount_due_cents` from the response with the `200` status
  - removed the required property `next_invoice/next_payment_attempt_unix` from the response with the `200` status
  - `header` request parameter `xi-api-key` list-of-types was widened by adding types `null`
  - for the `header` request parameter `xi-api-key`, the type was generalized from `string` to no type
  - added `#/components/schemas/InvoiceResponseModel, subschema #2` to the `next_invoice` response property `anyOf` list for the response status `200`
  - removed the `annual_period` enum value from the `billing_period` response property for the response status `200`
  - removed the `annual_period` enum value from the `character_refresh_period` response property for the response status `200`
  - removed the `eur` enum value from the `currency` response property for the response status `200`
  - removed the `monthly_period` enum value from the `billing_period` response property for the response status `200`
  - removed the `monthly_period` enum value from the `character_refresh_period` response property for the response status `200`
  - removed the `usd` enum value from the `currency` response property for the response status `200`
  - added the required property `max_character_limit_extension` to the response with the `200` status
  - added the required property `professional_voice_slots_used` to the response with the `200` status
  - added the required property `voice_slots_used` to the response with the `200` status
- **2024-05-07** `c1dd2ce19be9`: 2 info
  - added the required property `billing_period` to the response with the `200` status
  - added the required property `character_refresh_period` to the response with the `200` status
- **2023-08-12** `922ab0d49146`: 2 info
  - added the required property `max_voice_add_edits` to the response with the `200` status
  - added the required property `voice_add_edit_counter` to the response with the `200` status

---

[Operation](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/docs/v1/user/subscription/get.md) - [API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [Page](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/user/subscription/get)
