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

# Get Usage

`GET /usage`

## Request

- Base URL: `https://zeronoise.ai/api/v1`
- URL: `https://zeronoise.ai/api/v1/usage`
- Auth: HTTP bearer

Requires usage:read on an unbound organization credential and the current organization owner or admin role.

## Response `200`

Effective organization usage and limits

- Usage
  - `organization_id` string, required: Opaque identifier; clients must not parse its format.
  - `billing_status` string, required
  - `billable_actions_allowed` boolean, required
  - `blocker_code` string, nullable
  - `current_period` object, required
    - `start_at` string, date-time
    - `end_at` string, date-time
    - `included_usage_usd` string
    - `remaining_usage_usd` string
    - `on_demand_usage_usd` string
    - `on_demand_headroom_usd` string, nullable

## Other responses

- `default`: RFC 9457 problem response

---

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