# The coverage item object

Attributes:
- `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_id` (string, nullable): `null` means every competition.
- `territory` (string, nullable): Territory a site or grant applies to (ISO 3166-1 alpha-2).
- `from` (timestamp, nullable): A `Timestamp`, or `null` when unknown; the owning object says why.
- `to` (timestamp, nullable): A `Timestamp`, or `null` when unknown; the owning object says why.
- `status` (enum): `available`; `partial` (gaps inside the period, or only some covering sources may be displayed); `restricted` (limited by the caller's grant, or no covering source may be displayed; its period, sampling and `watermark_at` are then null and no source references are given); `unsupported` (the platform does not offer it); `unavailable` (temporarily cannot be served). One of: `available`, `partial`, `restricted`, `unsupported`, `unavailable`.
- `sampling_resolution_seconds` (integer, nullable)
- `watermark_at` (timestamp, nullable): A `Timestamp`, or `null` when unknown; the owning object says why.
- `sources` (object): Source references, or an explicit statement that they are withheld by source rights or unknown.
  - `status` (enum):  One of: `included`, `withheld`, `unknown`.
  - `items` (array of objects)
    - `source` (string): Source namespace (for example `footystats`).
    - `observed_at` (timestamp, nullable): A `Timestamp`, or `null` when unknown; the owning object says why.
    - `recorded_at` (timestamp): RFC 3339 instant in UTC with `Z` suffix; optional fractional seconds up to microseconds.
    - `precision` (enum): Precision of the source timestamp; `unknown` when the source gave none. One of: `unknown`, `day`, `hour`, `minute`, `second`, `millisecond`.

Example:

```json
{
  "dataset": "entities",
  "competition_id": "cmp_1",
  "territory": null,
  "from": "2026-08-01T00:00:00Z",
  "to": null,
  "status": "available",
  "sampling_resolution_seconds": null,
  "watermark_at": null,
  "sources": {
    "status": "included",
    "items": [
      {
        "source": "synthetic_alpha",
        "observed_at": "2026-09-25T08:55:00Z",
        "recorded_at": "2026-09-25T09:00:00Z",
        "precision": "minute"
      },
      {
        "source": "synthetic_beta",
        "observed_at": null,
        "recorded_at": "2026-09-01T00:00:00Z",
        "precision": "unknown"
      }
    ]
  }
}
```