---
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

---

[API](https://skmtc.dev/discolike/apis/discolike-api.md) · [All operations](https://skmtc.dev/discolike/apis/discolike-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discolike/discolike-api/revisions/8a39f6dd2666/schema)