curl -X GET 'https://api.elevenlabs.io/v1/user/subscription' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

# GET /v1/user/subscription (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> Get User Subscription Info

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X GET 'https://api.elevenlabs.io/v1/user/subscription' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

## Response (200 OK)
{"allowed_to_extend_character_limit":true,"billing_period":"monthly_period"}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

GET

/v1/user/subscription

ElevenLabs API

Get User Subscription Info

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 110 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X GET 'https://api.elevenlabs.io/v1/user/subscription' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Get a free ElevenLabs API key → sponsored

Parameters

No parameters.

Response 200 OK

{
  "allowed_to_extend_character_limit": true,
  "billing_period": "monthly_period",
  "can_extend_character_limit": true,
  "can_extend_voice_limit": true,
  "can_use_instant_voice_cloning": true,
  "can_use_professional_voice_cloning": true,
  "character_count": 1000,
  "character_limit": 10000,
  "character_refresh_period": "monthly_period",
  "currency": "usd",
  "current_overage": {
    "amount": "0",
    "currency": "usd"
  },
  "has_open_invoices": true,
  "has_used_creator_coupon_on_account": false,
  "has_used_starter_coupon_on_account": false,
  "max_character_limit_extension": 10000,
  "max_credit_limit_extension": 10000,
  "next_character_count_reset_unix": 1738356858,
  "next_invoice": {
    "amount_due_cents": 1000,
    "discounts": [
      {
        "discount_percent_off": 20
      }
    ],
    "next_payment_attempt_unix": 1738356858,
    "payment_intent_status": "processing",
    "payment_intent_statusses": [
      "processing",
      "succeeded"
    ],
    "subtotal_cents": 900,
    "tax_cents": 100
  },
  "open_invoices": [
    {
      "amount_due_cents": 1000,
      "discounts": [
        {
          "discount_percent_off": 20
        }
      ],
      "next_payment_attempt_unix": 1738356858,
      "payment_intent_status": "processing",
      "payment_intent_statusses": [
        "processing",
        "succeeded"
      ],
      "subtotal_cents": 900,
      "tax_cents": 100
    }
  ],
  "professional_voice_limit": 1,
  "professional_voice_slots_used": 0,
  "professional_voice_slots_used_in_workspace": 0,
  "status": "active",
  "tier": "starter",
  "voice_add_edit_counter": 0,
  "voice_limit": 10,
  "voice_slots_used": 1
}