# Usage API

**GET** `https://api.oneover.com/functions/v1/api-v1-usage`

**Scope:** `usage`

Balance snapshot or usage reporting for your organization.

## Query parameters

| Param | Description |
|-------|-------------|
| view | `balance` for credit snapshot; `usage` (default) for reporting |
| days | Usage window in days (default 30, max 90) |
| limit | Max requests returned (default 50, max 200) |

## Balance response (`?view=balance`)

```json
{
  "org_id": "uuid",
  "plan": "org_team",
  "balance": {
    "subscription_credits": 12000,
    "anytime_credits": 5000,
    "total_credits": 17000,
    "subscription_credits_expire_at": "2026-08-12T00:00:00Z"
  },
  "recent_ledger": []
}
```

## Usage response

Returns `summary`, `by_api_key`, `by_member`, and `requests` arrays.