Contents

API reference / Workspace

Usage and cost this month

GET /api/v1/usage

get_usage Read MCP tool

Mentions collected and judged, metered source calls and LLM tokens, against the plan's limits; what this workspace has cost this month in model and data spend, by feature (scanning, accounts, reviewing, ranking, threads, drafts) with the kinds of work in each (`cost`); the AI reviewer's allowance for today (`review`); the budget for paid sources and what is spent of it (`paid_sources`: X and LinkedIn run only inside a budget, and metered calls stop at the plan's number); and where the learning loop stands (`learning`: verdicts, what waits for review, which ranking model scores the workspace's posts). Costs are the ledger's list-price estimates.

Any API key or OAuth token, or a signed-in member.

Example

curl "https://sniffington.com/api/v1/usage" \
  -H "Authorization: Bearer $SCOUT_API_KEY"