---
title: "Your key: plan, limits and use so far"
method: GET
path: "/usage"
---

# Your key: plan, limits and use so far

`GET /usage`

## Request

- Base URL: `https://www.hillsignal.com/api/v1`
- URL: `https://www.hillsignal.com/api/v1/usage`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Calls used this minute and today, what is left today, and when the day resets. Checking does not use up your daily allowance.

Returns { key, plan, limits, used, remaining_today, day_resets_at, plans, docs }.

## Response `200`

OK

- object

## Other responses

- `400`: Error
- `401`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/hillsignal/apis/hillsignal-rest-api.md) · [All operations](https://skmtc.dev/hillsignal/apis/hillsignal-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hillsignal/apis/hillsignal-rest-api/revisions/043827c60767?raw)