---
title: "API key usage"
method: GET
path: "/keys/usage"
tags: ["Keys"]
---

# API key usage

`GET /keys/usage`

## Request

- Base URL: `https://api.onegoodarea.com`
- URL: `https://api.onegoodarea.com/keys/usage`
- Auth: HTTP bearer

Request totals, 30-day daily series, and active keys.

## Query parameters

- `org` string

## Response `200`

Default Response

- object
  - `totalRequests` number, required
  - `requestsThisMonth` number, required
  - `monthlyLimit` number, required
  - `unmetered` boolean, required
  - `userType` 'user' | 'engineering' | 'admin' | 'superuser', required
  - `band` 'fresh' | 'active' | 'approaching' | 'exhausted', required
  - `dailyData` object[], required
    - `day` string, required
    - `count` number, required
  - `lastRequestAt` string, date-time, required
  - `keys` object[], required
    - `id` string, required
    - `key_preview` string, required
    - `name` string, required
    - `created_at` string, date-time, required
    - `last_used_at` string, date-time, required
    - `training_optout` boolean, required
    - `managed` boolean, required

## Other responses

- `403`: Default Response
- `500`: Default Response

---

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