---
title: "Get account details"
method: GET
path: "/v1/account"
tags: ["Account"]
---

# Get account details

`GET /v1/account`

Get the current credit balance and subscription details of the account that owns the API key.

## Response `200`

200

- object
  - `id` string, required — Unique ID of the account that owns the API key.
  - `email` string, nullable, required — Email address of the account.
  - `tier` 'free' | 'creator' | 'pro' | 'business', required — Subscription tier in effect for the account. `free` if there is no active subscription, including while a subscription is `past_due`.
  - `credits` integer, required — Credits currently available to spend. Includes subscription credits and any purchased credit packs.
  - `subscription` object, nullable, required — Details of the account's subscription plan. `null` if the account has no subscription, e.g. a free account, an account that only purchased credit packs, or an account on usage-based API pricing. Reflects the plan currently configured on the subscription. If a plan change is scheduled, `tier` stays on the current plan until the next payment succeeds, so `tier` and `name` can briefly disagree.
    - `name` string, nullable, required — Name of the current subscription plan, e.g. `Creator`, `Pro`, `Pro Plus`, `Business`. `null` if the plan cannot be determined. Use `tier` for a machine-readable value.
    - `status` 'active' | 'past_due', required — Status of the subscription. - `active`: payments are up to date. - `past_due`: the latest payment failed. `tier` is `free` until payment succeeds. The subscription is canceled if payment keeps failing.
    - `price` object, required
      - `amount` integer, required — Price charged per billing interval, in the smallest unit of the currency (e.g. 4900 is $49.00 for `usd`). Discounts are not applied.
      - `currency` string, required — Three-letter ISO 4217 currency code, lowercase.
    - `discount` object, nullable, required — Discount applied to the subscription. `null` if no discount is applied.
      - `percent_off` number, nullable, required — Percentage taken off `price.amount` each billing interval. `null` if the discount is a fixed amount.
      - `amount_off` integer, nullable, required — Fixed amount taken off `price.amount` each billing interval, in the smallest unit of the currency. `null` if the discount is a percentage.
    - `billing_interval` 'month' | 'year' | 'null', nullable, required — How often the subscription is billed. `null` if unknown.
    - `current_period_end` string, date-time, nullable, required — End of the current billing period, in ISO 8601 format. The subscription renews at this time, or ends if `cancel_at_period_end` is `true`.
    - `cancel_at_period_end` boolean, required — Whether the subscription is scheduled to end at `current_period_end` instead of renewing. The subscription stays usable until then.

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

- **2026-09-07** `410521b75e33` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/magichourhq/apis/magic-hour-api/changes/v1/account/get.md)

---

[API](https://skmtc.dev/magichourhq/apis/magic-hour-api.md) · [All operations](https://skmtc.dev/magichourhq/apis/magic-hour-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magichourhq/apis/magic-hour-api/revisions/e1d2c7933d94?raw)