---
title: "Get current user info, remaining credits, and billing"
method: GET
path: "/v1/user/me"
tags: ["User"]
---

# Get current user info, remaining credits, and billing

`GET /v1/user/me`

## Request

- Base URL: `https://api.heygen.com`
- URL: `https://api.heygen.com/v1/user/me`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns the authenticated user's profile, remaining credits or balance, and billing details. The billing_type field indicates which billing object is populated: wallet (prepaid balance), subscription (OAuth credit pools), or usage_based (metered spending).

## Response `200`

Successful response

- object
  - `code` integer: API status code (100 = success)
  - `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
  - `message` string, nullable

## Other responses

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

## Changes

- **2026-11-03** `7dfa5e59b4f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/heygen/apis/heygen-external-api/changes/v1/user/me/get.md)

---

[API](https://skmtc.dev/heygen/apis/heygen-external-api.md) - [All operations](https://skmtc.dev/heygen/apis/heygen-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/heygen/apis/heygen-external-api/revisions/7dfa5e59b4f5?raw)