User

Get user account information and subscription details

Overview

The user client provides methods to retrieve information about your ElevenLabs account, including subscription details and usage limits.

get()

Retrieve information about the authenticated user.

Method Signature

client.user.get(
    request_options: Optional[RequestOptions] = None
) -> User

Parameters

request_options · RequestOptions

Request-specific configuration.

Returns

User object containing:

subscription · object

Information about your current subscription plan

Show subscription properties

tier · str

Subscription tier name (e.g., “free”, “starter”, “creator”, “pro”)

character_count · int

Number of characters available in your plan

character_limit · int

Total character limit for your subscription

can_extend_character_limit · bool

Whether you can purchase additional characters

allowed_to_extend_character_limit · bool

Whether character limit extension is allowed

next_character_count_reset_unix · int

Unix timestamp when character count resets

voice_limit · int

Maximum number of voices you can create

max_voice_add_edits · int

Maximum number of voice edits allowed

voice_add_edit_counter · int

Current number of voice edits used

professional_voice_limit · int

Maximum number of professional voice clones

can_use_instant_voice_cloning · bool

Whether instant voice cloning is available

can_use_professional_voice_cloning · bool

Whether professional voice cloning is available

is_new_user · bool

Whether this is a new user account

xi_api_key · str

Your API key (redacted in response)

Example

from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="YOUR_API_KEY")

# Get user information
user = client.user.get()

print(f"Subscription: {user.subscription.tier}")
print(f"Characters remaining: {user.subscription.character_count}")
print(f"Character limit: {user.subscription.character_limit}")
print(f"Voice limit: {user.subscription.voice_limit}")
print(f"Can use IVC: {user.subscription.can_use_instant_voice_cloning}")

Example Output

Subscription: creator
Characters remaining: 85432
Character limit: 100000
Voice limit: 30
Can use IVC: True

subscription

Access subscription-specific methods.

subscription.get()

Get detailed subscription information.

subscription = client.user.subscription.get()

print(f"Tier: {subscription.tier}")
print(f"Status: {subscription.status}")
print(f"Billing period: {subscription.billing_period}")

Async Usage

from elevenlabs import AsyncElevenLabs
import asyncio

async def get_user_info():
    client = AsyncElevenLabs(api_key="YOUR_API_KEY")
    
    user = await client.user.get()
    
    print(f"Subscription: {user.subscription.tier}")
    print(f"Characters: {user.subscription.character_count}/{user.subscription.character_limit}")

asyncio.run(get_user_info())

Use Cases

Usage Monitoring

Monitor your character usage and remaining quota

Feature Detection

Check which features are available in your plan

Billing Information

View subscription tier and renewal dates

Limit Management

Track voice limits and usage counters

Related Methods

• Usage - Detailed usage statistics
• Models - Available AI models