---
title: "Get Usage"
method: GET
path: "/usage"
tags: ["Usage"]
---

# Get Usage

`GET /usage`

Get your current credit usage for the rolling 30-day period.

## Response `200`

Current credit usage and limit

- UsageResponse — Response model for credit usage endpoint.
  - `credits_used` integer, required — Total credits used in the last 30 days.
  - `credit_limit` integer, nullable, required — Monthly credit limit. NULL means unlimited.
  - `is_over_limit` boolean, required — Whether the user has reached or exceeded their limit.
  - `available_at` string, date, nullable, required — Earliest date when expiring credits bring usage below limit. NULL if under limit or unlimited.
  - `daily_usage` DailyUsage[], required — Daily credit consumption with expiry dates for the rolling 30-day window.
    - `date` string, date, required
    - `credits` integer, required
    - `expires` string, date, required

---

[API](https://skmtc.net/shovels/apis/the-shovels-api-v2.md) · [All operations](https://skmtc.net/shovels/apis/the-shovels-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shovels/the-shovels-api-v2/revisions/d3f0e1f3afa8/schema)