Get overall usage summary
Get an overall usage summary with totals across all tasks. Includes total costs, task counts by status, usage breakdown by model, and time-based trends.
Access control:
- Solo users (not in a team): Returns their own usage summary
- Team admins: Returns aggregated summary for all team members (includes by_email breakdown)
- Team members/viewers: No access (returns 403)
Authorizations
JWT authentication token
Query Parameters
Filter from datetime (ISO 8601)
Filter to datetime (ISO 8601)
Group by time period
day, week, month Response
Usage summary
Usage statistics by model
Task counts by status
Total Neo credits used
Total number of tasks
Usage statistics by team member email, sorted by neo_credits descending (only for team admins)
Usage statistics by time period (only if group_by is specified)
Usage statistics by project, sorted by neo_credits descending. Pure usage analytics (no spending caps).
BYOK (Bring Your Own Key) usage breakdown
Grand total credits ever issued. For subscription customers, the sum of every monthly subscription grant (subscription_grant/renew/proration) plus all top-up purchases and positive admin amount grants. For non-subscription customers, top-up purchases and admin amount grants only. Not reduced by usage, expiry, or cancellation.
Total task spend counted from the most recent admin usage reset (reset_usage event); all-time when no admin reset exists. Independent of subscription renewal/settlement window moves.
When set, the datetime from which credit usage is counted. Usage before this date is excluded from used/available credit calculations.
When set, credits will be frozen (available=0) after this date. NULL means never expires.
Whether the Neo credits have expired (expires_at is in the past)
Total agent triggers
Available Neo credits since last reset (issued - used since reset). Not affected by date filters. Returns 0 if credits are expired.
Total execution time in milliseconds
Total Neo credits issued/allocated to the user
Neo credits used since the last reset (issued - available). Not affected by date filters.
Total steps executed
Total tool calls

