# The usage object

Attributes:
- `principal` (object)
  - `type` (enum):  One of: `user`, `api_client`.
  - `id` (string)
- `organization_id` (uuid, nullable): Account identifier of an organization (UUID); organizations are accounts, not football entities.
- `from` (timestamp): RFC 3339 instant in UTC with `Z` suffix; optional fractional seconds up to microseconds.
- `to` (timestamp): RFC 3339 instant in UTC with `Z` suffix; optional fractional seconds up to microseconds.
- `requests` (object): Logical requests in the window. `metered` counts billable units once per logical request, however often it was retried; `cached` and `rejected` are reported separately and not metered.
  - `metered` (integer)
  - `cached` (integer)
  - `rejected` (integer)
- `quota` (object)
  - `limit` (integer, nullable)
  - `remaining` (integer, nullable)
  - `resets_at` (timestamp, nullable): A `Timestamp`, or `null` when unknown; the owning object says why.
- `limits` (array of objects): Every limit that applies to the caller, in the order `requests_per_minute`, `requests_per_day`, then any per-dataset allowance, each in its window that contains the usage window's last instant (pass `to` just after the current instant for the current minute). An organization lists its configured limits (`requests_per_minute` counts every request, the allowances only requests in flight or served); a caller without an organization lists the default per-caller `requests_per_minute`, counting its recorded requests (refusals included, so `used` may exceed `limit`) and this one. `quota` repeats the `requests_per_day` entry.
  - `limit_kind` (enum):  One of: `requests_per_minute`, `requests_per_day`.
  - `limit` (integer)
  - `used` (integer)
  - `remaining` (integer)
  - `window_start` (timestamp): RFC 3339 instant in UTC with `Z` suffix; optional fractional seconds up to microseconds.
  - `resets_at` (timestamp): RFC 3339 instant in UTC with `Z` suffix; optional fractional seconds up to microseconds.
- `policy_version` (string)

Example:

```json
{
  "principal": {
    "type": "api_client",
    "id": "c0a80002-0000-4000-8000-000000000071"
  },
  "organization_id": "c0a80001-0000-4000-8000-000000000071",
  "from": "2026-10-01T00:00:00Z",
  "to": "2026-10-02T00:00:00Z",
  "requests": {
    "metered": 0,
    "cached": 0,
    "rejected": 0
  },
  "quota": {
    "limit": 10000,
    "remaining": 10000,
    "resets_at": "2026-10-02T00:00:00Z"
  },
  "limits": [
    {
      "limit_kind": "requests_per_minute",
      "limit": 600,
      "used": 0,
      "remaining": 600,
      "window_start": "2026-10-01T23:59:00Z",
      "resets_at": "2026-10-02T00:00:00Z"
    },
    {
      "limit_kind": "requests_per_day",
      "limit": 10000,
      "used": 0,
      "remaining": 10000,
      "window_start": "2026-10-01T00:00:00Z",
      "resets_at": "2026-10-02T00:00:00Z"
    }
  ],
  "policy_version": "2026-10-15.1"
}
```