Plan, credit balance, grants and recent usage

{
  "plan": {
    "name": "Free"
  },
  "balance": {
    "settled": 19940,
    "granted": 20000,
    "creditValueUsd": 0.001
  },
  "aiWallet": {
    "settled": 1000,
    "granted": 1025,
    "creditValueUsd": 0.01,
    "recharged": true
  },
  "credits": {
    "balance": 49716.547,
    "held": 22.5,
    "currency": "credits"
  },
  "rates": [
    {
      "feature": "Parse — Simple Page",
      "unit": "page",
      "credits": 5
    }
  ],
  "grants": [
    {
      "reason": "plan",
      "granted": 20000,
      "remaining": 19940,
      "grantedAt": "2026-07-26T17:41:42Z",
      "expiresAt": "2027-07-26T17:41:42Z"
    }
  ],
  "usage": [
    {
      "at": "2026-07-25T12:00:00Z",
      "event": "page_extracted",
      "feature": "Extraction — Smart",
      "quantity": 3,
      "credits": -45,
      "dimensions": {}
    }
  ]
}

The plan and usage summary the Settings → Billing screen renders. Its rates come from the advertised catalog and carry a price for every row — for the plan’s own credit price list, including the meters it does not price, read GET /api/billing/rates. Authorization: any member of the organization.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

The organization’s plan view.

planobject

balanceobject

aiWalletobject

creditsobject

rateslist of objects

grantslist of objects

usagelist of objects

Errors

503

Service Unavailable Error