Prediction: Groups

LineupAPI predictions are organized into groups so you can request only what you need:

/predictions/{fixtureId}/?groups=lineups,minutes,goals&apiKey=...

Each row in the CSV is a player in the fixture, and each group contributes additional columns.

CSV format

All prediction endpoints return CSV.
Only /predictions/metadata/{fixtureId} returns JSON (model + snapshot metadata).

Base fixture columns

fixtureId — fixture UUID (Universally unique identifier).
commence_time — Kickoff time in UTC (ISO 8601), e.g. 2025-04-24T17:00:00Z.
competition.id — competition UUID.
competition.name — name of the competition.
competition.country — competition country code (ISO-3), e.g. ESP.
home_team.id — home team UUID.
home_team.name — home team name.
home_team.founded — Founding year (string), e.g. 1920.
home_team.country — Team country code (ISO-3), e.g. ESP.
away_team.id
away_team.name
away_team.founded
away_team.country

Base predictions columns

These columns identify the player and team:

playerId — player UUID (Universally unique identifier)
teamId — team UUID
teamName — team name
firstName, lastName
position — e.g. GK, DEF, MID, FW

`lineups` — Who plays?

This group models match involvement of the player.
It answers: Will the player start, be subbed in from bench, or not play at all?

Columns:

lineups.starter — % chance the player starts in the starting 11
lineups.benchAndPlay — % chance the player comes on as a substitute
lineups.notPlay — % chance the player does not play any minutes

Note

These outcomes are designed to cover all scenarios and sum up to 100%.

`minutes` — Minutes played buckets

This group predicts how many minutes a player is likely to play, represented as probabilities for minute ranges.

Columns:

minutes.1_44 — % chance the player plays between 1–44 minutes
minutes.45_59 — % chance the player plays 45–59 minutes
minutes.60_89 — % chance the player plays 60–89 minutes
minutes.90 — % chance the player plays the full match (90+ minutes)

Note

These outcomes are designed to cover all scenarios and sum up to 100%.

Warning

The minutes group and all following (goals, assists, cards, ...) are to be interpreted together with the lineups group.
These probabilities assume the player has started the match and do not account for a player beeing subbed on the field.

See: Prediction Dependency

`goals` — Goal thresholds

This group returns probabilities for goal thresholds (per player).

Columns:

goals.over_0.5 — % chance the player scores 1+ goals
goals.over_1.5 — % chance the player scores 2+
goals.over_2.5 — % chance the player scores 3+

How to read it

These are threshold probabilities, not expected goals.
The chance of exactly 0 goals is 100% - goals.over_0.5.
The chance of under 1.5 goals is 100% - goals.over_1.5.
over_1.5 will always be less than or equal to over_0.5 (because 2+ is harder than 1+).