---
title: "Get User Info"
method: GET
path: "/v1/user"
---

# Get User Info

`GET /v1/user`

Gets information about the user

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- UserResponseModel
  - `user_id` string, required — The unique identifier of the user.
  - `subscription` SubscriptionResponseModel, required
    - `tier` string, required — The tier of the user's subscription.
    - `character_count` integer, required — The number of characters used by the user.
    - `character_limit` integer, required — The maximum number of characters allowed in the current billing period.
    - `max_character_limit_extension` integer, nullable, required — Deprecated: use `max_credit_limit_extension`. Maximum number of characters that the character limit can be exceeded by. Managed by the workspace admin.
    - `max_credit_limit_extension` union, required — Maximum number of credits that the credit limit can be exceeded by. Managed by the workspace admin. `"unlimited"` means no cap, `0` means usage-based billing is disabled.
      - integer
      - 'unlimited'
    - `can_extend_character_limit` boolean, required — Whether the workspace is entitled to enter overages (usage-based billing).
    - `allowed_to_extend_character_limit` boolean, required — Deprecated: use `max_credit_limit_extension != 0`. Whether the user is allowed to extend their character limit.
    - `next_character_count_reset_unix` integer, nullable — The Unix timestamp of the next character count reset.
    - `voice_slots_used` integer, required — The number of voice slots used by the user.
    - `professional_voice_slots_used` integer, required — The number of professional voice slots used. For consolidated billing this is the group-wide count across all workspaces in the group; see professional_voice_slots_used_in_workspace for the current workspace only.
    - `professional_voice_slots_used_in_workspace` integer, required — The number of professional voice slots used in the current workspace. For consolidated billing, professional_voice_slots_used counts across all workspaces in the group, while this counts only the current workspace.
    - `voice_limit` integer, required — The maximum number of voice slots allowed for the user.
    - `max_voice_add_edits` integer, nullable — The maximum number of voice add/edits allowed for the user.
    - `voice_add_edit_counter` integer, required — The number of voice add/edits used by the user.
    - `professional_voice_limit` integer, required — The maximum number of professional voices allowed for the user.
    - `can_extend_voice_limit` boolean, required — Whether the user can extend their voice limit.
    - `can_use_instant_voice_cloning` boolean, required — Whether the user can use instant voice cloning.
    - `can_use_professional_voice_cloning` boolean, required — Whether the user can use professional voice cloning.
    - `currency` 'usd' | 'eur' | 'inr' | 'pln'
    - `current_overage` Price, required — Currency/amount pair.
      - `amount` string, required
      - `currency` 'usd' | 'eur' | 'inr' | 'pln', required
    - `status` 'trialing' | 'active' | 'incomplete' | 'past_due' | 'free' | 'free_disabled', required
    - `billing_period` 'monthly_period' | '3_month_period' | '6_month_period' | 'annual_period'
    - `character_refresh_period` 'monthly_period' | '3_month_period' | '6_month_period' | 'annual_period'
  - `is_new_user` boolean, required — Whether the user is new. This field is deprecated and will be removed in the future. Use 'created_at' instead.
  - `xi_api_key` string, nullable — The API key of the user.
  - `can_use_delayed_payment_methods` boolean, required — This field is deprecated and will be removed in a future major version. Instead use subscription.trust_on_invoice_creation.
  - `is_onboarding_completed` boolean, required — Whether the user's onboarding is completed.
  - `is_onboarding_checklist_completed` boolean, required — Whether the user's onboarding checklist is completed.
  - `show_compliance_terms` boolean — Whether to show compliance terms (ToS, Privacy Policy, biometric consent) during onboarding. Set for users signing up from the marketing site.
  - `first_name` string, nullable — First name of the user.
  - `is_api_key_hashed` boolean — Whether the user's API key is hashed.
  - `xi_api_key_preview` string, nullable — The preview of the user's API key.
  - `referral_link_code` string, nullable — The referral link code of the user.
  - `partnerstack_partner_default_link` string, nullable — The Partnerstack partner default link of the user.
  - `created_at` integer, required — The unix timestamp of the user's creation. 0 if the user was created before the unix timestamp was added.
  - `seat_type` 'workspace_admin' | 'workspace_member' | 'workspace_lite_member', required — Seat types for workspace members.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/57d56f34628a/schema)