---
title: "Account snapshot — balance, tier, and credit tranches"
method: GET
path: "/api/v1/me"
---

# Account snapshot — balance, tier, and credit tranches

`GET /api/v1/me`

Returns the account snapshot for the current user: credit balance, active
credit tranches, auto-recharge settings, and current pricing tier. All
monetary fields are integer EUR cents (1 EUR = 100 cents).

## Response `200`

Account snapshot for the authenticated user.

- MeResponse — Authenticated user snapshot. All monetary fields are integer EUR cents (1 EUR = 100 cents).
  - `api_usage_tier` integer, required — Current pricing tier level. Higher levels unlock better rate limits and job concurrency.
  - `auto_recharge` AutoRechargeState
    - `below_eur_cents` integer, required — When the available balance drops below this many EUR cents, a recharge is triggered.
    - `enabled` boolean, required — Whether auto-recharge is active for this account.
    - `has_stripe_customer` boolean, required — Whether a Stripe customer record exists (required for auto-recharge to run).
    - `meter_cents` integer, required — EUR cents charged via auto-recharge in the current UTC calendar month.
    - `meter_month` string, date, nullable — UTC month start for `meter_cents`; null if no auto-recharge has run this month.
    - `monthly_cap_cents` integer, required — Maximum EUR cents that may be charged via auto-recharge per UTC calendar month. 0 = no cap.
    - `target_eur_cents` integer, required — Balance target after a successful recharge, in EUR cents.
  - `available_eur_cents` integer, required — Spendable balance in EUR cents — `balance_eur_cents` minus any credits held for in-flight async jobs.
  - `balance_eur_cents` integer, required — Total credit balance in EUR cents, before deducting active holds.
  - `euro_tranches` EuroTranche[], required — Active credit grants (non-empty, unexpired), consumed in `expires_at` ascending order.
    - `created_at` string, date-time, required
    - `expires_at` string, date-time, required
    - `id` string, uuid, required
    - `initial_eur_cents` integer, required — Original size of this tranche in EUR cents.
    - `remaining_eur_cents` integer, required — Unconsumed balance remaining in this tranche, in EUR cents.
    - `source` string, required — Origin of the tranche — one of `signup_trial`, `stripe`, `partner`, `legacy`. Other labels may appear for custom grants.
  - `has_ever_paid` boolean, required — True once the account has completed at least one successful Stripe payment.
  - `lifetime_paid_cents` integer, required — Cumulative EUR cents charged across all Stripe payments, all time.
  - `payment_count` integer, required — Total number of successful Stripe payments on this account.
  - `role` 'user' | 'admin', required — Account role. `admin` accounts can sign in to the staff back-office; regular accounts are `user`.
  - `signup_trial` object, nullable — Present when a free trial tranche was granted at signup. Omitted for accounts with no trial.
    - `expires_at` string, date-time
    - `granted_at` string, date-time
    - `initial_eur_cents` integer
    - `remaining_eur_cents` integer
  - `user_id` string, uuid, required

## Other responses

- `401` — Missing or invalid bearer token.

---

[API](https://skmtc.net/sybilion/apis/sybilion-api.md) · [All operations](https://skmtc.net/sybilion/apis/sybilion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sybilion/sybilion-api/versions/2ba1f4c6f25d/schema)