---
title: "Get API usage statistics"
method: GET
path: "/usage"
---

# Get API usage statistics

`GET /usage`

Returns month-to-date and historical usage statistics including requests, records, and spend.

## Response `200`

Successful Response

- UsageResponse — Response from the /usage endpoint.
  - `account_status` string — Account status
  - `month_to_date_requests` integer, required — The total number of requests for the current month
  - `month_to_date_records` integer, required — The total number of records returned for the current month
  - `month_to_date_spend` number, required — The total amount spent for the current month
  - `max_spend` union — Maximum monthly spend limit ('unlimited' if no limit)
    - number
    - string
  - `total_available_spend` union — Total available spend ('unlimited' if no limit)
    - number
    - string
  - `carryover_credits` number — Carryover credits from previous periods
  - `top_up_credits` number — Top-up credits added to account
  - `usage_summary` object — Usage history grouped by month (YYYY-MM), with a list of entries per user
  - `recent_companies_billed` integer — Net-new company records billed in the trailing 30 days
  - `recent_contacts_billed` integer — Net-new contact records billed in the trailing 30 days
  - `estimated_provider_spend_recent` number, nullable — Best-effort estimate of third-party LLM/search spend on the customer's own API keys for task runs in the trailing 30 days. Estimate only - never a DiscoLike charge.
  - `billing_events` BillingEvent[] — Recent billing events (trailing 30 days, newest first, max 500)
    - `created_at` string, date-time, required — When the event was billed
    - `action` string, required — Endpoint or task type that produced the charge
    - `user_email` string, nullable — Billing user (session or MCP OAuth); None for API-key events
    - `api_key_id` integer, nullable — API key id for API-key events
    - `api_key_description` string, nullable — Human description of the API key (joined from admin.api_keys); None for user events
    - `task_id` string, nullable — Queue task that produced the event, when applicable
    - `companies_billed` integer — Net-new company records billed
    - `contacts_billed` integer — Net-new contact records billed
    - `cost_usd` number — DiscoLike charge for this event in USD

---

[API](https://skmtc.net/discolike/apis/discolike-api.md) · [All operations](https://skmtc.net/discolike/apis/discolike-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/discolike/discolike-api/versions/3248fc62024c/schema)