---
title: "Plan, quota and usage for the calling key (or, without a key, the anonymous allowance of this network)"
method: GET
path: "/v1/usage"
---

# Plan, quota and usage for the calling key (or, without a key, the anonymous allowance of this network)

`GET /v1/usage`

## Request

- Base URL: `https://shotkiln.com`
- URL: `https://shotkiln.com/v1/usage`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - none

## Response `200`

Usage

- object
  - `plan` string
  - `plan_name` string
  - `authenticated` boolean
  - `month` object
    - `used` integer
    - `limit` integer
  - `day` object
    - `used` integer
    - `limit` integer, nullable
  - `per_minute` integer
  - `watermark` boolean
  - `billing` boolean: true when the key belongs to a paid subscription (POST /v1/billing/portal works)
  - `resets_at` string, date-time: when the monthly quota resets (UTC)

## Other responses

- `401`: Invalid or revoked API key

---

[API](https://skmtc.dev/shotkiln/apis/shotkiln-api.md) · [All operations](https://skmtc.dev/shotkiln/apis/shotkiln-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shotkiln/apis/shotkiln-api/revisions/8123a05b6719?raw)