GET /api/v1/me

Read-only snapshot of the authenticated user. Use this to display balance, current pricing tier, and trial status. All monetary fields are integer EUR cents (100 cents = €1.00). Manage account settings such as auto top-up in the Developers Portal — they are exposed read-only here for reference.

Attribute	Details
Auth	Required (401 if missing/invalid)
Query	None

Response

{
  "user_id": "1f2a8b3e-4c5d-46d7-9a01-2b3c4d5e6f70",
  "balance_eur_cents": 1234,
  "available_eur_cents": 1134,
  "api_usage_tier": 1,
  "lifetime_paid_cents": 5000,
  "payment_count": 1,
  "has_ever_paid": true,
  "euro_tranches": [
    {
      "id": "9c8d7e6f-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
      "source": "stripe",
      "initial_eur_cents": 5000,
      "remaining_eur_cents": 3865,
      "expires_at": "2027-04-30T10:05:00Z",
      "created_at": "2026-04-30T10:05:00Z"
    }
  ],
  "signup_trial": {
    "granted_at": "2026-04-15T10:00:00Z",
    "initial_eur_cents": 100,
    "remaining_eur_cents": 0,
    "expires_at": "2026-04-30T10:00:00Z"
  },
  "auto_recharge": {
    "enabled": false,
    "below_eur_cents": 0,
    "target_eur_cents": 0,
    "monthly_cap_cents": 0,
    "meter_cents": 0,
    "has_stripe_customer": true,
    "meter_month": null
  }
}

Field reference

Top-level

Field	Meaning
user_id	Stable UUID for the caller.
balance_eur_cents	Ledger balance in EUR cents (top-ups, charges, refunds, grants).
available_eur_cents	balance_eur_cents minus active holds for in-flight async jobs, in EUR cents.
api_usage_tier	Your current pricing tier level. Drives rate-limit and concurrency caps — see Tiers & signup trial.
lifetime_paid_cents	Your all-time top-up total in EUR cents.
payment_count	Number of successful top-ups on your account.
has_ever_paid	true once your first top-up settles.

When async forecast jobs are running, holds reserve part of the balance until each job settles or fails; then available_eur_cents moves back toward balance_eur_cents.

euro_tranches[]

Active grants that still have a positive balance and have not expired (remaining_eur_cents > 0 AND expires_at > now()). Tranches are consumed in expires_at ASC order.

Field	Meaning
id	UUID of the grant.
source	One of signup_trial, stripe, partner, legacy. Other labels may appear for custom grants.
initial_eur_cents	Amount initially granted in the tranche, in EUR cents.
remaining_eur_cents	Amount left after charges and holds, in EUR cents.
expires_at	RFC3339 timestamp. Always present — every tranche has an expiry (top-ups are typically valid for 1 year).
created_at	RFC3339 timestamp the grant was inserted.

signup_trial

Present only when the caller received a free trial grant on first authentication; the field is omitted otherwise. See Tiers & signup trial.

Field	Meaning
granted_at	RFC3339 timestamp the trial was granted.
initial_eur_cents	Amount granted at signup, in EUR cents.
remaining_eur_cents	Trial amount left, in EUR cents (drops to 0 after expiry sweep).
expires_at	RFC3339 timestamp or omitted.

auto_recharge

Read-only snapshot of your auto top-up settings (enabled boolean plus the configured trigger / target / monthly cap). The exact field set may evolve. Configure auto top-up from the Developers Portal — there is no public API or SDK to change it.