billing
team

Billing Usage Breakdown

Return per-AI-action usage rollup for the user's last 30 days.

Items list is sorted by total_quantity DESC (highest-cost AI actions first) so the FE can render the user's AI activity summary at a glance. Empty list for new users with no AI usage events. Currently scoped to the 12 AI surfaces that call report_usage() — see BILL-01 comment above the route for the design intent.

get/api/billing/usage/breakdown

Request

  • Base URL: https://www.oxfordledge.com (the document declares no server; this is the origin it was published from)
  • URL: https://www.oxfordledge.com/api/billing/usage/breakdown
  • Auth: none declared

Response

Successful Response

total_quantityinteger required

Sum of total_quantity across all items — the user's total credits used in the window. UI uses to compute per-action percentages.

window_daysinteger required

Number of days the rollup covers (always 30 for now; field exists for future per-billing-cycle alignment).

Changes

No recorded changes to this operation across all 1 revision of this API.