Get user subscription

Gets extended information about the users subscription

Response

Successful Response

tierstring

The tier of the user's subscription.

character_countinteger

The number of characters used by the user.

character_limitinteger

The maximum number of characters allowed in the current billing period.

can_extend_character_limitboolean

Whether the user can extend their character limit.

allowed_to_extend_character_limitboolean

Whether the user is allowed to extend their character limit.

voice_slots_usedinteger

The number of voice slots used by the user.

professional_voice_slots_usedinteger

The number of professional voice slots used by the workspace/user if single seat.

voice_limitinteger

The maximum number of voice slots allowed for the user.

voice_add_edit_counterinteger

The number of voice add/edits used by the user.

professional_voice_limitinteger

The maximum number of professional voices allowed for the user.

can_extend_voice_limitboolean

Whether the user can extend their voice limit.

can_use_instant_voice_cloningboolean

Whether the user can use instant voice cloning.

can_use_professional_voice_cloningboolean

Whether the user can use professional voice cloning.

statusenum

The status of the user's subscription.

has_open_invoicesboolean

Whether the user has open invoices.

max_character_limit_extensioninteger or null

Maximum number of characters that the character limit can be exceeded by. Managed by the workspace admin.

next_character_count_reset_unixinteger or null

The Unix timestamp of the next character count reset.

max_voice_add_editsinteger or null

The maximum number of voice add/edits allowed for the user.

currencyenum or null

The currency of the user's subscription.

Allowed values:

billing_periodenum or null

The billing period of the user's subscription.

Allowed values:

character_refresh_periodenum or null

The character refresh period of the user's subscription.

Allowed values:

next_invoiceobject or null

The next invoice for the user.

1	from elevenlabs import ElevenLabs
2
3	client = ElevenLabs(
4	api_key="YOUR_API_KEY",
5	)
6	client.user.subscription.get()

1	{
2	"tier": "foo",
3	"character_count": 42,
4	"character_limit": 42,
5	"can_extend_character_limit": true,
6	"allowed_to_extend_character_limit": true,
7	"voice_slots_used": 42,
8	"professional_voice_slots_used": 42,
9	"voice_limit": 42,
10	"voice_add_edit_counter": 42,
11	"professional_voice_limit": 42,
12	"can_extend_voice_limit": true,
13	"can_use_instant_voice_cloning": true,
14	"can_use_professional_voice_cloning": true,
15	"status": "trialing",
16	"has_open_invoices": false,
17	"max_character_limit_extension": 42,
18	"next_invoice": {
19	"amount_due_cents": 1000,
20	"next_payment_attempt_unix": 1738356858
21	}
22	}

Headers

Response

Errors