---
title: "GET /v1/usage"
method: GET
path: "/v1/usage"
tags: ["Billing"]
---

# GET /v1/usage

`GET /v1/usage`

## Request

- Base URL: `https://api.taada.dev`
- URL: `https://api.taada.dev/v1/usage`
- Auth: HTTP bearer

## Response `200`

Default Response

- object
  - `plan` object, required
    - `id` 'free' | 'solo' | 'team' | 'scale' | 'enterprise', required
    - `name` string, required
    - `priceCents` integer, nullable, required
    - `overageCents` integer, nullable, required
    - `voice` boolean, required
    - `retentionDays` integer, nullable, required
    - `blocksMerge` boolean
  - `meters` object[], required
    - `id` 'runs' | 'repositories', required
    - `label` string, required
    - `used` integer, required
    - `limit` integer, nullable, required
  - `overage` object, nullable, required
    - `runs` integer, required
    - `cents` integer, required
  - `spendCapCents` integer, nullable, required
  - `byRepository` object[], required
    - `id` string, required
    - `name` string, required
    - `runs` integer, required
    - `owner` string, nullable, required
  - `byPerson` object[], nullable, required
    - `id` string, required
    - `name` string, required
    - `runs` integer, required
  - `team` object, required
    - `role` 'payer' | 'member' | 'solo', required
    - `payerName` string, nullable, required
    - `ownPlanPaid` boolean, required
  - `resetsAt` string, required
  - `enforced` boolean, required

---

[API](https://skmtc.dev/taada/apis/tada.md) · [All operations](https://skmtc.dev/taada/apis/tada/llms.txt) · [OpenAPI document](https://skmtc.dev/taada/apis/tada/revisions/9079c5c8a580?raw)