# Metered usage and quota of the caller's organization

`GET /v1/me/usage`

Logical metered requests for the caller's organization (or the user alone when
there is none) in `[from, to)`; default is the current allowance period. The
window is bounded to 93 days. Server-side retries and cache hits are reported
separately and never counted twice. `limits` reports every limit that applies to
the caller. The call consumes no allowance but counts towards the per-minute rate
limit like every request.

Parameters:
- `from` (query, timestamp, optional): 
- `to` (query, timestamp, optional): 

Returns `200`: Usage summary.
The body is [the usage object](obj-Usage.md).

Errors: `400` Malformed parameter or cursor (`invalid-request`).; `401` Missing or invalid credential (`unauthenticated`).; `403` Operation not permitted (`forbidden`) or restricted by grants/rights (`not-entitled`).; `422` Well-formed but unanswerable (`invalid-range`, `unsupported-historical-capability`).; `429` The per-minute rate limit is used up (`rate-limited`) or a daily allowance is exhausted (`quota-exceeded`). Failed requests (403, 404, other 4xx, 5xx) use up the per-minute rate limit too.; `500` Unexpected failure (`internal-error`); `request_id` identifies the server-side record.; `503` A service this operation depends on, or the access check, is temporarily unavailable (`unavailable`, `policy-unavailable`).

Example request (200 · Default):

```bash
curl -G https://api.example.com/v1/me/usage \
  -H "X-API-Key: $ODDSFINDER_API_KEY" \
  -d from=2026-10-01T00:00:00Z \
  -d to=2026-10-02T00:00:00Z
```

Example response (200):

```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"
}
```