---
title: "Get current rate-limit consumption"
method: GET
path: "/usage"
tags: ["Observability"]
---

# Get current rate-limit consumption

`GET /usage`

## Request

- Base URL: `https://app.buildworkpro.com/api/v1`
- URL: `https://app.buildworkpro.com/api/v1/usage`
- Auth: HTTP bearer

Returns the calling tenant's current rate-limit consumption for both the tenant-wide cost-weighted budget (sliding hour) and the per-API-key request limit (sliding minute). Use this to surface live consumption in developer dashboards or to back off proactively before hitting `429`. Data is sourced from the same Redis-backed buckets that the rate limiter writes to, so the numbers returned here are exactly the limits enforced.

## Response `200`

Current usage

- object
  - `data` UsageResponse, required
    - `tenant` object, required: Tenant-wide cost-weighted budget (sliding hour window)
      - `limit` integer, required
      - `used` integer, required
      - `remaining` integer, required
      - `resetSeconds` integer, required
      - `windowSeconds` integer, required
    - `apiKey` object, nullable, required: Per-API-key request limit (sliding minute window). Null when the caller is OAuth/refresh-token authenticated (not an API key).
      - `limit` integer, required
      - `used` integer, required
      - `remaining` integer, required
      - `resetSeconds` integer, required
      - `windowSeconds` integer, required
  - `meta` ResponseMeta, required
    - `request_id` string: Server-generated request identifier
    - `pagination` PaginationMeta
      - `cursor` string, nullable, required: Opaque cursor for the next page; null when no more results
      - `has_more` boolean, required: Whether more pages are available after this one
      - `count` integer, required: Items in this page

## Other responses

- `403`: Scope insufficient

---

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