<!-- Source: https://docs.geopera.com/api-reference/operations/usage · Markdown for LLMs -->

<!-- AUTO-GENERATED by scripts/generate-api-reference.cjs from the committed OpenAPI spec. Do not edit by hand. -->

# Usage operations

Usage metering.

Each operation below is reachable at `POST /v1/op/{operation_id}` or the resource path `POST /v1/{resource}/{action}`, with a Bearer token (a `gpra_` API key or a session token). Back to the [Operations Reference](/api-reference/operations) index.

## `usage.current`

Usage stats for the current billing period (storage, tiles, credits, jobs).

| | |
|---|---|
| **Scope** | `usage:read` |
| **Side-effect** | read |
| **HTTP** | `POST /v1/op/usage.current`  ·  `POST /v1/usage/current` |
| **Python / TypeScript** | `client.usage.current(…)` |
| **CLI** | `geopera usage current …` |

**Request** — `UsageCurrentInput`

| Field | Type | Required | Description |
|---|---|---|---|
| `organization_id` | string | yes |  |

**Response** — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.

## `usage.history`

Historical usage (tile requests + peak storage) for the past N months.

| | |
|---|---|
| **Scope** | `usage:read` |
| **Side-effect** | read |
| **HTTP** | `POST /v1/op/usage.history`  ·  `POST /v1/usage/history` |
| **Python / TypeScript** | `client.usage.history(…)` |
| **CLI** | `geopera usage history …` |

**Request** — `UsageHistoryInput`

| Field | Type | Required | Description |
|---|---|---|---|
| `organization_id` | string | yes |  |
| `months` | integer | — |  |

**Response** — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.

## `usage.recalculate_storage`

Recalculate an org's storage from actual stored assets (org admin).

| | |
|---|---|
| **Scope** | `usage:write` |
| **Side-effect** | compute |
| **HTTP** | `POST /v1/op/usage.recalculate_storage`  ·  `POST /v1/usage/recalculate_storage` |
| **Python / TypeScript** | `client.usage.recalculate_storage(…)` |
| **CLI** | `geopera usage recalculate-storage …` |

**Request** — `RecalculateInput`

| Field | Type | Required | Description |
|---|---|---|---|
| `organization_id` | string | yes |  |

**Response** — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.