v2

latestOpenAPI 3.0.32026-07-26112274.7 KB

Account snapshot — balance, tier, and credit tranches

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).

get/api/v1/me

Response

Account snapshot for the authenticated user.

api_usage_tierinteger required

Current pricing tier level. Higher levels unlock better rate limits and job concurrency.

available_eur_centsinteger required

Spendable balance in EUR cents — balance_eur_cents minus any credits held for in-flight async jobs.

balance_eur_centsinteger required

Total credit balance in EUR cents, before deducting active holds.

has_ever_paidboolean required

True once the account has completed at least one successful Stripe payment.

lifetime_paid_centsinteger required

Cumulative EUR cents charged across all Stripe payments, all time.

payment_countinteger 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.

user_idstring uuid required

Example response

{
  "user_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "balance_eur_cents": 4750,
  "available_eur_cents": 4250,
  "api_usage_tier": 1,
  "lifetime_paid_cents": 10000,
  "payment_count": 2,
  "has_ever_paid": true,
  "role": "user",
  "euro_tranches": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "source": "stripe",
      "initial_eur_cents": 5000,
      "remaining_eur_cents": 4750,
      "created_at": "2026-05-01T09:00:00Z",
      "expires_at": "2027-05-01T09:00:00Z"
    }
  ]
}