# The fixture sidelined object

A fixture's sidelined players as known at the cutoff (`GET /v1/fixtures/{id}/sidelined`).

Attributes:
- `fixture_id` (string): Fixture identifier (`fx_<digits>`).
- `status` (enum): `available` = the entries are served; `unavailable` = no entry is known for the fixture at the cutoff (the source sent no list, which does not mean every player was fit); `withheld` = entries exist but a source of them holds no right to serve sidelined players to this caller. One of: `available`, `unavailable`, `withheld`.
- `entries` (array of objects): Injuries first, then suspensions, then doubtful players; within each by start date (none last); empty unless `status` is `available`.
  - `id` (string): Sidelined entry identifier (`sdl_<digits>`).
  - `version` (integer)
  - `person_id` (string): The sidelined person, canonical at the cutoff.
  - `team_id` (string): The person's side, canonical at the cutoff.
  - `side` (enum):  One of: `home`, `away`.
  - `category` (enum): `injury`, `suspended` or `doubtful` (the source lists the person as sidelined, but he may still play). One of: `injury`, `suspended`, `doubtful`.
  - `start_date` (date, nullable): The day the spell began; `null` means unavailable.
  - `end_date` (date, nullable): The day the spell ended or is expected to end; `null` when the source does not know.
  - `games_missed` (integer, nullable): The games the spell has cost as of the source's capture; `null` means unavailable.
  - `completed` (boolean, nullable): The source's flag that the spell is over as of its capture (not at the fixture's date); `null` means unavailable.
  - `recorded_at` (timestamp): When the platform recorded this version (`known_at` compares against it).
- `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`.
- `knowledge` (object): The effective knowledge cutoff of the response. Under a grant freshness delay it is never later than the request time minus the delay, whatever `known_at` asked for.
  - `known_at` (timestamp): RFC 3339 instant in UTC with `Z` suffix; optional fractional seconds up to microseconds.
  - `as_requested` (boolean): True when the caller supplied `known_at`; false when it defaulted to the request time.
- `resolution` (object): How the requested identifier resolved. Present whenever the requested identifier is not the canonical one, and optional otherwise.
  - `requested_id` (string): OddsFinder identifier, `<prefix>_<digits>`, a per-kind sequence number without padding, leading zeros, grouping or sign (1 to 9223372036854775807). The prefix names the kind; the per-kind schemas fix it where a field or parameter has one kind. `Resolution` uses this generic form because its identifiers are of the resource's kind.
  - `canonical_id` (string): OddsFinder identifier, `<prefix>_<digits>`, a per-kind sequence number without padding, leading zeros, grouping or sign (1 to 9223372036854775807). The prefix names the kind; the per-kind schemas fix it where a field or parameter has one kind. `Resolution` uses this generic form because its identifiers are of the resource's kind.
  - `status` (enum): `canonical`: the requested identifier is the identity itself; `alias`: it was retired by a merge decision and resolves to `canonical_id`. One of: `canonical`, `alias`.
  - `decision_id` (string, nullable): Identifier of a merge or reversal decision (`dec_<digits>`), a record you can cite.
  - `decided_at` (timestamp, nullable): A `Timestamp`, or `null` when unknown; the owning object says why.

Example:

```json
{
  "fixture_id": "fx_1",
  "status": "withheld",
  "entries": [],
  "knowledge": {
    "known_at": "2026-10-03T19:00:00Z",
    "as_requested": false
  }
}
```