---
title: "Get Current User"
method: GET
path: "/v3/users/me"
tags: ["User"]
---

# Get Current User

`GET /v3/users/me`

Returns the authenticated user's profile, remaining credits or balance, and billing details.

## Response `200`

Successful response

- object
  - `data` UserInfoResponse
    - `username` string, required
    - `email` string, nullable, required
    - `first_name` string, nullable, required
    - `last_name` string, nullable, required
    - `billing_type` 'wallet' | 'subscription' | 'usage_based' — Discriminator for billing fields. Exactly one of wallet / subscription / usage_based is populated depending on this value. - wallet: prepaid balance in USD (or credits for Enterprise), API key auth - subscription: per-pool credit balances, OAuth integration apps - usage_based: metered billing with optional spending cap
    - `wallet` WalletInfo
      - `currency` 'usd' | 'credits', required
      - `remaining_balance` number, nullable
      - `auto_reload` AutoReloadInfo
        - `enabled` boolean, required
        - `threshold_usd` number, nullable
        - `amount_usd` number, nullable
    - `subscription` SubscriptionInfo
      - `plan` 'free' | 'starter' | 'creator' | 'pro' | 'team' | 'enterprise' | 'business_plus', required
      - `credits` SubscriptionCredits, required
        - `premium_credits` CreditPool
          - `remaining` integer, nullable
          - `resets_at` string, nullable
        - `add_on_credits` CreditPool
          - `remaining` integer, nullable
          - `resets_at` string, nullable
    - `usage_based` UsageBasedInfo
      - `spending_current_usd` number, nullable
      - `spending_cap_usd` number, nullable
      - `included_credits` number, nullable
      - `remaining_credits` number, nullable

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication failed
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/heygen/apis/heygen-external-api.md) · [All operations](https://skmtc.net/heygen/apis/heygen-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heygen/heygen-external-api/revisions/e2e54726e210/schema)