---
title: "Get the account behind this API key"
method: GET
path: "/account"
tags: ["Account"]
---

# Get the account behind this API key

`GET /account`

## Request

- Base URL: `https://api.lumabill.ch/v1`
- URL: `https://api.lumabill.ch/v1/account`
- Auth: HTTP bearer

Returns billing and plan info for the account: subscription state,
plan type, enabled modules, AI quota, locale, and login email.

The account is the user/billing layer (one Cognito identity, one
Stripe customer). Profiles are company-scoped and live under the
account - see `/profiles` for that data.

## Response `200`

Account object

- Account: The account is the user/billing layer (Cognito identity, Stripe customer, plan, modules, AI quota). Distinct from a `Profile`, which holds company-scoped invoicing data.
  - `id` string, uuid, required
  - `email` string, email, required: Login email (Cognito identity).
  - `plan_type` string, required
  - `subscription_status` string, required
  - `stripe_customer_id` string, nullable
  - `stripe_price_id` string, nullable
  - `past_due_since` string, date-time, nullable
  - `email_preferences` object
  - `modules` string[]
  - `ai_quota_limit` integer
  - `ai_quota_used` integer
  - `ai_quota_reset_at` string, date-time, nullable
  - `profile_limit` integer
  - `locale` string
  - `trial_ends_at` string, date-time, nullable
  - `last_login_at` string, date-time, nullable
  - `created_at` string, date-time, required

## Other responses

- `401`: Invalid or missing API key
- `403`: Subscription required or read-only key on a write endpoint
- `404`: Resource not found
- `429`: Rate limit exceeded
- `500`: Internal server error

---

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