GET
/
v1
/
user
/
subscription
from elevenlabs import ElevenLabs

client = ElevenLabs(
    api_key="YOUR_API_KEY",
)
client.user.get_subscription()

{
  "tier": "<string>",
  "character_count": 123,
  "character_limit": 123,
  "can_extend_character_limit": true,
  "allowed_to_extend_character_limit": true,
  "next_character_count_reset_unix": 123,
  "voice_limit": 123,
  "max_voice_add_edits": 123,
  "voice_add_edit_counter": 123,
  "professional_voice_limit": 123,
  "can_extend_voice_limit": true,
  "can_use_instant_voice_cloning": true,
  "can_use_professional_voice_cloning": true,
  "currency": "usd",
  "status": "trialing",
  "billing_period": "monthly_period",
  "character_refresh_period": "monthly_period",
  "next_invoice": {
    "amount_due_cents": 123,
    "next_payment_attempt_unix": 123
  },
  "has_open_invoices": true
}

Headers

​
xi-api-key
string

Your API key. This is required by most endpoints to access our API programatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

200
application/json
Successful Response
​
tier
string
required
​
character_count
integer
required
​
character_limit
integer
required
​
can_extend_character_limit
boolean
required
​
allowed_to_extend_character_limit
boolean
required
​
next_character_count_reset_unix
integer
required
​
voice_limit
integer
required
​
max_voice_add_edits
integer
required
​
voice_add_edit_counter
integer
required
​
professional_voice_limit
integer
required
​
can_extend_voice_limit
boolean
required
​
can_use_instant_voice_cloning
boolean
required
​
can_use_professional_voice_cloning
boolean
required
​
currency
enum<string>
required
Available options:
usd,
eur
​
status
enum<string>
required
Available options:
trialing,
active,
incomplete,
incomplete_expired,
past_due,
canceled,
unpaid,
free
​
billing_period
enum<string>
required
Available options:
monthly_period,
annual_period
​
character_refresh_period
enum<string>
required
Available options:
monthly_period,
annual_period
​
next_invoice
object
required
​
has_open_invoices
boolean
required

Was this page helpful?

Suggest editsRaise issue