Usage, billing and activity

These operations read what your organization used, its billing status, and what happened in its projects.

All paths are under https://api.mubit.ai, with a management key in Authorization: Bearer. Management API covers keys, roles, pagination, retries and errors. The samples read the key from MUBIT_MANAGEMENT_KEY.

Get usage

GET /api/v1/usage

Returns the calls, runs and tokens counted, and what the runs cost (spend_usd): totals for the window, and in data a row for each project and UTC day. The window is start_date to end_date, both UTC days included. Counts go back 61 days before today: a window that starts earlier, or ends after today, is 400 validation. Left out, end_date is today and start_date is the first day of that month.

Role: read or higher.

curl "https://api.mubit.ai/api/v1/usage?start_date=2026-11-01" \
  -H "Authorization: Bearer $MUBIT_MANAGEMENT_KEY"

Response 200: Usage figures

Each item of data:

{
  "start_date": "2026-10-01",
  "end_date": "2026-10-26",
  "total_calls": 15420,
  "total_runs": 15420,
  "total_tokens": 3200400,
  "spend_usd": "4.20",
  "data": [
    {
      "date": "2026-10-25",
      "project": "prj_prod",
      "calls": 6220,
      "runs": 6220,
      "tokens_in": 1100000,
      "tokens_out": 196400,
      "spend_usd": "1.70"
    },
    {
      "date": "2026-10-26",
      "project": "prj_prod",
      "calls": 9200,
      "runs": 9200,
      "tokens_in": 1500000,
      "tokens_out": 404000,
      "spend_usd": "2.50"
    }
  ]
}

Get billing status

GET /api/v1/billing

Returns whether runs are counted (runs_status) and the payment card (has_card, card_last4). Both card fields are null for now, which means not known, not "no card": test for null before you test for false. A key of role admin also gets the credit balance (balance_usd); for other keys the field is left out. Billing belongs to the organization, so a key bound to one project gets 403 project_scoped.

Role: read or higher.

curl "https://api.mubit.ai/api/v1/billing" \
  -H "Authorization: Bearer $MUBIT_MANAGEMENT_KEY"

Response 200: Billing status

{
  "balance_usd": "50.00",
  "has_card": null,
  "card_last4": null,
  "runs_status": "active"
}

List activity

GET /api/v1/activity

Lists your projects' training, rollout, access and policy events, newest first: the newest 100 events of each project. Older events aren't reachable here. project limits the feed to one project; a key bound to one project reads that project's.

Role: read or higher.

curl "https://api.mubit.ai/api/v1/activity?project=$PROJECT_ID" \
  -H "Authorization: Bearer $MUBIT_MANAGEMENT_KEY"

Response 200: Activity list

Each item of data:

{
  "data": [
    {
      "id": "act_rollout:ad-a:1793012400000000:0000",
      "actor": "person:user_one",
      "kind": "version.promoted",
      "description": "Version 2 of \"Support Triage\" promoted",
      "created_at": "2026-10-26T11:00:00Z",
      "project": "prj_prod"
    }
  ],
  "next_cursor": null
}