---
title: "Get Billing Account"
method: GET
path: "/admin/billing/accounts/{user_id}"
tags: ["admin", "billing"]
---

# Get Billing Account

`GET /admin/billing/accounts/{user_id}`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/admin/billing/accounts/{user_id}`
- Auth: OAuth 2
  - Password
  - Token URL: `api/login`

## Path parameters

- `user_id` string, required

## Response `200`

Successful Response

- BillingAccountDetailResponse
  - `user` AdminAccountUserResponse, required
    - `user_id` string, required
    - `name` string, nullable, required
    - `first_name` string, nullable, required
    - `last_name` string, nullable, required
    - `email` string, nullable, required
    - `role` string, nullable, required
    - `created_at` string, date-time, nullable, required
    - `last_seen_at` string, date-time, nullable, required
    - `school_covered` boolean, required
    - `offer_open` boolean, required
    - `has_excellence_plus_flag` boolean, required
    - `stripe_customer_id` string, nullable, required
  - `entitlement` Entitlement, required
    - `tier` 'discovery' | 'plus', required
    - `source` 'school' | 'subscription' | 'complimentary'
    - `until` string, date-time, nullable
    - `will_renew` boolean
    - `grant_kind` 'free_month' | 'admin' | 'free_offer' | 'referral_week' | 'referral_month' | 'legacy_grace'
  - `subscriptions` AdminSubscriptionResponse[], required
    - `provider` string, required
    - `provider_subscription_id` string, required
    - `provider_customer_id` string, nullable, required
    - `status` string, required
    - `plan_key` string, nullable, required
    - `price_lookup_key` string, nullable, required
    - `quantity` integer, required
    - `payer_kind` string, required
    - `payer_email` string, nullable, required
    - `current_period_end` string, date-time, nullable, required
    - `trial_end` string, date-time, nullable, required
    - `cancel_at_period_end` boolean, required
    - `canceled_at` string, date-time, nullable, required
    - `ended_at` string, date-time, nullable, required
    - `created_at` string, date-time, nullable, required
    - `entitles` boolean, required
    - `stripe_dashboard_url` string, nullable, required
  - `grants` AdminGrantResponse[], required
    - `id` string, nullable, required
    - `kind` 'free_month' | 'admin' | 'free_offer' | 'referral_week' | 'referral_month' | 'legacy_grace', required
    - `starts_at` string, date-time, required
    - `ends_at` string, date-time, required
    - `active` boolean, required
    - `granted_by` string, nullable, required
    - `granted_by_name` string, nullable, required
    - `note` string, nullable, required
    - `created_at` string, date-time, nullable, required
  - `parent_requests` AdminParentRequestResponse[], required
    - `id` string, nullable, required
    - `parent_email` string, required
    - `status` string, required
    - `created_at` string, date-time, required
    - `expires_at` string, date-time, required
    - `paid_at` string, date-time, nullable, required
    - `share_activity_consent` boolean, required
  - `usage_14d` UsageDay[], required
    - `date` string, date, required
    - `ai_requests` integer, nullable
    - `chat_messages` integer, nullable
    - `exercise_sessions` integer, nullable
  - `admin_actions` AdminActionResponse[], required
    - `at` string, date-time, required
    - `admin_name` string, nullable, required
    - `action` string, required
    - `details` object, required
  - `usage_override` UsageOverride: An admin's test values for one account (stored on the user).
    - `day_ratio` number
    - `week_ratio` number
    - `limit` UsageLimit: Which limit refuses: the shared meter on one of its windows, or a feature's cap.
      - `feature` 'chat' | 'photo_correction' | 'session_start' | 'library_exercise' | 'copy_review' | 'auto_evaluation' | 'generation' | 'voice' | 'library' | 'recommended_session', required
      - `limit` 'meter' | 'cap', required
      - `window` 'day' | 'week' | 'month', required
  - `referral` AccountReferralResponse, required
    - `code` string, nullable, required
    - `made` AdminReferralResponse[], required
      - `id` string, required
      - `code` string, required
      - `status` 'attached' | 'week_granted' | 'paid' | 'month_granted' | 'blocked_same_card' | 'canceled' | 'capped', required
      - `referrer` ReferralPerson, required
        - `user_id` string, required
        - `name` string, nullable
        - `email` string, nullable
      - `referee` ReferralPerson, required
        - `user_id` string, required
        - `name` string, nullable
        - `email` string, nullable
      - `created_at` string, date-time, required
      - `week_granted_at` string, date-time, nullable, required
      - `paid_at` string, date-time, nullable, required
      - `month_due_at` string, date-time, nullable, required
      - `month_granted_at` string, date-time, nullable, required
      - `referee_week` Reward, required
        - `kind` 'grant' | 'credit', required
        - `at` string, date-time, required
        - `grant_id` string, nullable
        - `ends_at` string, date-time, nullable
        - `credit_cents` integer, nullable
        - `customer_id` string, nullable
      - `referrer_week` Reward, required
        - `kind` 'grant' | 'credit', required
        - `at` string, date-time, required
        - `grant_id` string, nullable
        - `ends_at` string, date-time, nullable
        - `credit_cents` integer, nullable
        - `customer_id` string, nullable
      - `referrer_month` Reward, required
        - `kind` 'grant' | 'credit', required
        - `at` string, date-time, required
        - `grant_id` string, nullable
        - `ends_at` string, date-time, nullable
        - `credit_cents` integer, nullable
        - `customer_id` string, nullable
    - `referred_by` AdminReferralResponse, required
      - `id` string, required
      - `code` string, required
      - `status` 'attached' | 'week_granted' | 'paid' | 'month_granted' | 'blocked_same_card' | 'canceled' | 'capped', required
      - `referrer` ReferralPerson, required
        - `user_id` string, required
        - `name` string, nullable
        - `email` string, nullable
      - `referee` ReferralPerson, required
        - `user_id` string, required
        - `name` string, nullable
        - `email` string, nullable
      - `created_at` string, date-time, required
      - `week_granted_at` string, date-time, nullable, required
      - `paid_at` string, date-time, nullable, required
      - `month_due_at` string, date-time, nullable, required
      - `month_granted_at` string, date-time, nullable, required
      - `referee_week` Reward, required
        - `kind` 'grant' | 'credit', required
        - `at` string, date-time, required
        - `grant_id` string, nullable
        - `ends_at` string, date-time, nullable
        - `credit_cents` integer, nullable
        - `customer_id` string, nullable
      - `referrer_week` Reward, required
        - `kind` 'grant' | 'credit', required
        - `at` string, date-time, required
        - `grant_id` string, nullable
        - `ends_at` string, date-time, nullable
        - `credit_cents` integer, nullable
        - `customer_id` string, nullable
      - `referrer_month` Reward, required
        - `kind` 'grant' | 'credit', required
        - `at` string, date-time, required
        - `grant_id` string, nullable
        - `ends_at` string, date-time, nullable
        - `credit_cents` integer, nullable
        - `customer_id` string, nullable

## Other responses

- `404`: Resource not found
- `422`: Validation Error

## Changes

> 106 revisions in range; 1 not diffed.

- **2026-11-12** `0af74c49ba7a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/admin/billing/accounts/:user_id/get.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/de6afcc9656f?raw)
