# The fixture statistics object

A fixture's team and player statistics as known at the cutoff (`GET /v1/fixtures/{id}/statistics`).

Attributes:
- `fixture_id` (string): Fixture identifier (`fx_<digits>`).
- `status` (enum): `available` = at least one value is served; `unavailable` = no value matching the filters is known at the cutoff; `withheld` = matching values exist but no source of them holds a display right for statistics. One of: `available`, `unavailable`, `withheld`.
- `statistics` (array of objects): Home side first; a side's own values, then its players by person identifier; then metric and period scope. Empty unless `status` is `available`.
  - `id` (string): Statistic observation identifier (`st_<digits>`).
  - `version` (integer)
  - `team_id` (string): The side the value belongs to, canonical at the cutoff.
  - `person_id` (string, nullable): The player the value describes (canonical at the cutoff); `null` for the side's own value (not applicable).
  - `lineup_entry_id` (string, nullable): The player's lineup entry as `GET /v1/fixtures/{id}/lineups` serves it to the same caller at the same cutoff; `null` for a team value or when no served entry names him.
  - `metric` (enum): A metric code of the curated statistics vocabulary; each metric has one unit. One of: `goals`, `own_goals`, `assists`, `shots_total`, `shots_on_target`, `shots_off_target`, `shots_blocked`, `shots_inside_box`, `shots_outside_box`, `goal_attempts`, `hit_woodwork`, `big_chances_created`, `big_chances_missed`, `chances_created`, `key_passes`, `passes`, `passes_accurate`, `passes_accurate_percentage`, `passes_successful`, `passes_successful_percentage`, `passes_final_third`, `backward_passes`, `long_balls`, `long_balls_won`, `long_balls_won_percentage`, `long_passes`, `long_passes_successful`, `long_passes_successful_percentage`, `through_balls`, `through_balls_won`, `crosses_total`, `crosses_accurate`, `crosses_accurate_percentage`, `ball_possession`, `attacks`, `dangerous_attacks`, `ball_safe`, `touches`, `turnovers`, `possession_lost`, `dispossessed`, `duels_total`, `duels_won`, `duels_lost`, `duels_won_percentage`, `aerials_total`, `aerials_won`, `aerials_lost`, `aerials_won_percentage`, `successful_headers`, `dribbles_attempted`, `dribbles_successful`, `dribbles_successful_percentage`, `dribbled_past`, `tackles`, `tackles_won`, `tackles_won_percentage`, `last_man_tackles`, `interceptions`, `clearances`, `blocks`, `ball_recoveries`, `offsides_provoked`, `errors_leading_to_shot`, `saves`, `saves_inside_box`, `punches`, `high_claims`, `goals_conceded`, `goalkeeper_goals_conceded`, `goal_kicks`, `fouls_committed`, `fouls_drawn`, `yellow_cards`, `second_yellow_cards`, `red_cards`, `offsides`, `corners`, `free_kicks`, `throw_ins`, `substitutions`, `injuries`, `minutes_played`, `cumulative_minutes_played`, `rating`.
  - `unit` (enum): The metric's unit; `percent` is 0..100 as the source sends it, `rating_0_10` a source's own player rating. One of: `count`, `percent`, `minutes`, `rating_0_10`.
  - `period_scope` (enum): The part of the match a value covers. `first_half` and `second_half` are each half alone; `as_reported` is the source's whole match where the source does not say whether extra time is included. One of: `first_half`, `second_half`, `regulation_time`, `regulation_and_extra_time`, `including_penalties`, `pre_match`, `as_reported`.
  - `value` (number): The value as the source sent it (a value with more than four decimals is rounded to four).
  - `definition_version` (string): The source definition the value was mapped under (`sportmonks.1`); values of two definitions are not comparable. It names the source, so it follows the source-reference rules of `sources`, per value; it is present only with the `read:sources` scope and when the value's source holds a display right for statistics, and left out otherwise.
  - `recorded_at` (string): When the platform recorded this version (`known_at` compares against it).
- `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.
- `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
{
  "fixture_id": "fx_1",
  "status": "withheld",
  "statistics": [],
  "knowledge": {
    "known_at": "2026-10-03T16:00:00Z",
    "as_requested": false
  }
}
```