---
title: "Review usage for the active workspace over a 7/30/90-day window"
method: GET
path: "/v1/usage"
tags: ["dashboard"]
---

# Review usage for the active workspace over a 7/30/90-day window

`GET /v1/usage`

## Request

- Base URL: `https://api.tently.dev`
- URL: `https://api.tently.dev/v1/usage`
- Auth: none declared

## Query parameters

- `days` integer
- `repoId` string, uuid

## Response `200`

Default Response

- object
  - `windowDays` integer, required
  - `repoId` string, uuid, nullable, required
  - `from` string, date-time, required
  - `to` string, date-time, required
  - `allowance` object, required
    - `used` integer, required
    - `limit` integer, nullable, required
    - `base` integer, nullable, required
    - `state` 'ok' | 'warning' | 'reached' | 'unlimited', required
    - `periodEnd` string, date-time, required
    - `periodStart` string, date-time
  - `costVisible` boolean, required
  - `current` object, required
    - `prsReviewed` integer, required
    - `reviews` integer, required
    - `failedReviews` integer, required
    - `skippedReviews` integer, required
    - `issues` integer, required
    - `highSeverityIssues` integer, required
    - `medianTimeToReviewMs` number, nullable, required
    - `p90TimeToReviewMs` number, nullable, required
    - `medianCostPerPrUsd` number, nullable, required
    - `p90CostPerPrUsd` number, nullable, required
    - `totalCostUsd` number, nullable, required
  - `previous` object, required
    - `prsReviewed` integer, required
    - `reviews` integer, required
    - `failedReviews` integer, required
    - `skippedReviews` integer, required
    - `issues` integer, required
    - `highSeverityIssues` integer, required
    - `medianTimeToReviewMs` number, nullable, required
    - `p90TimeToReviewMs` number, nullable, required
    - `medianCostPerPrUsd` number, nullable, required
    - `p90CostPerPrUsd` number, nullable, required
    - `totalCostUsd` number, nullable, required
  - `daily` object[], required
    - `date` string, required
    - `reviews` integer, required
    - `failed` integer, required
    - `skipped` integer, required
    - `issues` integer, required
    - `highSeverityIssues` integer, required
    - `costUsd` number, nullable, required
  - `byRepo` object[], required
    - `repoId` string, uuid, required
    - `repoFullName` string, required
    - `prsReviewed` integer, required
    - `reviews` integer, required
    - `issues` integer, required
    - `medianTimeToReviewMs` number, nullable, required
    - `costUsd` number, nullable, required

## Other responses

- `401`: Default Response
- `403`: Default Response
- `503`: Default Response

---

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