# Get Usage

> Return per-meter current counts + the active plan's gates.

Canonical URL: https://docs.botyard.io/docs/api/usage/get_usage_v1_orgs__org_id__usage_get

`GET /v1/orgs/{org_id}/usage`

Return per-meter current counts + the active plan's gates.

When the org has no subscription, returns an empty snapshot
(``meters: []``) so the FE can render its plan-required state without
a separate code path. Caps and prices come from ``plan_meter_gates``;
counts come from the same helpers ``GateEnforcer`` uses, so what the
user sees lines up with what the cap will block on.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `org_id` | path | yes | string |  |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| `200` | Successful Response | OrgUsageSnapshot |
| `default` | RFC 9457 Problem Details error response | ProblemDetails |

Full schemas: operation `get_usage_v1_orgs__org_id__usage_get` in the OpenAPI spec at https://api.botyard.io/openapi.json.