# The entitlements 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.
- `scopes` (array of strings)
- `grant_version` (string, nullable)
- `source_rights_version` (string, nullable)
- `policy_version` (string)
- `territory` (string, nullable): Cross-dataset summary (the first territory any grant names); each read applies its own dataset's grant in `datasets[].territories`.
- `freshness_delay_seconds` (integer): Cross-dataset summary (the largest delay of any grant); each read applies its own dataset's grant in `datasets[].freshness_delay_seconds`.
- `lookback_days` (integer, nullable)
- `datasets` (array of objects)
  - `dataset` (enum): The datasets access is granted for. `coverage` and `account` are governed by scope only and never appear in an organization's grants or in coverage items. `lineups` (team sheets, `GET /v1/fixtures/{id}/lineups`), `statistics` (player and team match statistics, `GET /v1/fixtures/{id}/statistics`) and `events` (match events and sidelined players, `GET /v1/fixtures/{id}/events` and `/sidelined`) and `context` (officials and conditions, `GET /v1/fixtures/{id}/officials` and `/conditions`) are granted per organization like `entities` and read with the `read:entities` scope. One of: `entities`, `lineups`, `statistics`, `events`, `context`, `coverage`, `account`.
  - `competition_ids` (array of strings, nullable): `null` means every competition.
  - `territories` (array of strings, nullable): `null` means no territory restriction.
  - `freshness_delay_seconds` (integer)
  - `lookback_days` (integer, nullable): `null` means unlimited history depth.

Example:

```json
{
  "principal": {
    "type": "api_client",
    "id": "c0a80002-0000-4000-8000-000000000071"
  },
  "organization_id": "c0a80001-0000-4000-8000-000000000071",
  "scopes": [
    "read:coverage",
    "read:entities",
    "read:me",
    "read:sources"
  ],
  "grant_version": "context:1,entities:1,events:1,lineups:1,statistics:1",
  "source_rights_version": "v1",
  "policy_version": "2026-10-15.1",
  "territory": null,
  "freshness_delay_seconds": 0,
  "lookback_days": null,
  "datasets": [
    {
      "dataset": "context",
      "competition_ids": null,
      "territories": null,
      "freshness_delay_seconds": 0,
      "lookback_days": null
    },
    {
      "dataset": "entities",
      "competition_ids": null,
      "territories": null,
      "freshness_delay_seconds": 0,
      "lookback_days": null
    },
    {
      "dataset": "events",
      "competition_ids": null,
      "territories": null,
      "freshness_delay_seconds": 0,
      "lookback_days": null
    },
    {
      "dataset": "lineups",
      "competition_ids": null,
      "territories": null,
      "freshness_delay_seconds": 0,
      "lookback_days": null
    },
    {
      "dataset": "statistics",
      "competition_ids": null,
      "territories": null,
      "freshness_delay_seconds": 0,
      "lookback_days": null
    }
  ]
}
```