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

# Get usage

`GET /usage`

## Request

- Base URL: `https://arena-predictions.com/api/v1`
- URL: `https://arena-predictions.com/api/v1/usage`
- Auth: HTTP bearer

The key's account against its plan: requests this month (all keys together) and this minute, when each resets, this key's own count, and whether the limits refuse requests yet. Any valid key; never counted.

## Response `200`

Where the account stands.

- Usage
  - `tier` 'none' | 'basic' | 'builder' | 'desk' | 'enterprise', required: none: signed in, without a plan.
  - `month` object, required
    - `limit` integer, required
    - `used` integer, required
    - `resetsAt` string, date-time, required
  - `minute` object, required
    - `limit` integer, required
    - `remaining` integer, required
    - `resetsAt` string, date-time, required
  - `key` object, required
    - `prefix` string, required
    - `requestsThisMonth` integer, required
    - `lastUsedAt` string, date-time, nullable, required
  - `enforced` boolean, required: False while the limits only count (observe mode): nothing is refused.

## Other responses

- `401`: Missing, malformed, unknown, revoked or expired key.
- `503`: Usage could not be read right now.

---

[API](https://skmtc.dev/arena-predictions/apis/arena-api.md) · [All operations](https://skmtc.dev/arena-predictions/apis/arena-api/llms.txt) · [OpenAPI document](https://skmtc.dev/arena-predictions/apis/arena-api/revisions/9d89d166dae6?raw)