Billing

Get current user and billing state

Returns the authenticated user's local identity, plan, subscription status, and credit totals. Credit totals include top-level, monthly, and daily buckets consumed by the desktop billing UI.

get/v1/me

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/me
  • Auth: HTTP bearer

Response

Current user and billing state.

Example response

{
  "billing": {
    "plan": "free",
    "status": "trialing",
    "trialExpiresAt": "2026-07-01T00:00:00.000Z",
    "usage": {
      "availableCredits": 9875,
      "daily": {
        "availableCredits": 9975,
        "sanctionedCredits": 10000,
        "usageDay": "2026-06-04",
        "usedCredits": 25
      },
      "monthly": {
        "availableCredits": 9875,
        "sanctionedCredits": 10000,
        "usedCredits": 125
      },
      "sanctionedCredits": 10000,
      "usedCredits": 125
    }
  },
  "user": {
    "email": "user@example.com",
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Changes

No operation changes recorded.