Per-user usage reporting, built on one endpoint.

Everything below is rendered from GET /v1/account/usage — the same call your platform makes to see which end-users ran which tools, on which surface, over time. Numbers here are simulated for a fictional partner; no real account data is shown.

API calls · last 6 months

17,965

Calls this period (2026-06)

5,230

Active end-users

493

MCP share

70%

Call volume by month from=2026-01&to=2026-06

Surface split group_by=surface

Top tools group_by=tool

Top end-users group_by=user

How it's wired

# one call — scoped to YOUR account by the bearer token
curl "https://api.planfi.app/v1/account/usage\
  ?group_by=user,tool&from=2026-06&to=2026-06" \
  -H "Authorization: Bearer pft_…"

Pass X-Planfi-User-Id on each tool call and every row is attributed to that end-user. group_by accepts any comma list of user · key · surface · tool; from/to are YYYY-MM.

// response (shape — values simulated)
{
  "partnerId": "pt_demo_8K2xZ",
  "from": "2026-06",
  "to": "2026-06",
  "group_by": [
    "user",
    "tool"
  ],
  "total": 5230,
  "rows": [
    {
      "user": "user_8842",
      "tool": "generate_financial_plan",
      "count": 214
    },
    {
      "user": "user_8842",
      "tool": "run_backtesting",
      "count": 190
    },
    {
      "user": "user_1023",
      "tool": "analyze_roth_conversion",
      "count": 138
    },
    {
      "user": "user_5567",
      "tool": "analyze_tax_loss_harvesting",
      "count": 96
    },
    {
      "user": "…",
      "tool": "…",
      "count": 0
    }
  ]
}