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

# Get Usage

`GET /usage`

## Request

- Base URL: `https://api.shovels.ai/v2`
- URL: `https://api.shovels.ai/v2/usage`
- Auth: API key in header `X-API-Key`

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.dev/shovels/apis/the-shovels-api-v2.md) - [All operations](https://skmtc.dev/shovels/apis/the-shovels-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/shovels/apis/the-shovels-api-v2/revisions/e9f48948b723?raw)