API Field Reference

GRID Esports API field version requirements

Back to Home

This reference documents the minimum API version required for each field in the GRID Esports Series State API. Fields are organized by category and tagged with their version requirements.

Version Changelog (24 version levels, 90 fields, 3386 matches)

Base Support
54 fields109 matches
series base, games base, teams base, players base, draftActions, inventory, objectives base
v3.2
2 fields259 matches
totalMoneyEarned
v3.3
1 fields384 matches
respawnClock
v3.7
1 fields163 matches
games.startedAt
v3.10
1 fields84 matches
firstKill
v3.11
2 fields252 matches
completedFirst
v3.14
1 fields20 matches
series.duration
v3.15
1 fields159 matches
games.duration
v3.23
4 fields0 matches
damageDealt, damageTaken
v3.24
2 fields0 matches
damagePerMinute
v3.25
1 fields0 matches
damagePercentage
v3.26
2 fields0 matches
damagePerMoney
v3.27
2 fields0 matches
kdaRatio
v3.28
1 fields0 matches
moneyDifference
v3.30
2 fields79 matches
visionScore
v3.33
2 fields0 matches
visionScorePerMinute
v3.34
2 fields0 matches
killsAndAssists
v3.35
1 fields84 matches
killParticipation
v3.36
2 fields0 matches
moneyPerMinute
v3.37
1 fields0 matches
moneyPercentage
v3.38
1 fields209 matches
baronPowerPlays
v3.40
1 fields0 matches
majorMoneyLead
v3.41
1 fields0 matches
majorMoneyDeficit
v3.42
2 fields1584 matches
forwardPercentage
Base Supported by all versionsv3.xx Requires this version or higher
Series Level Fields
idBase
formatBase
startedBase
finishedBase
startedAtBase
durationv3.14
Series Teams Fields
idBase
nameBase
scoreBase
wonBase
killsBase
deathsBase
idBase
nameBase
Games Base Fields
idBase
sequenceNumberBase
startedBase
finishedBase
startedAtv3.7
durationv3.15
Draft Actions Fields
typeBase
sequenceNumberBase
idBase
typeBase
idBase
typeBase
nameBase
Game Teams Base Fields
idBase
nameBase
sideBase
wonBase
killsBase
deathsBase
netWorthBase
Game Teams LOL Extension (GameTeamStateLol)
experiencePointsBase
totalMoneyEarnedv3.2
firstKillv3.10
damageDealtv3.23
damageTakenv3.23
damagePerMinutev3.24
damagePerMoneyv3.26
visionScorev3.30
visionScorePerMinutev3.33
moneyDifferencev3.28
moneyPerMinutev3.36
kdaRatiov3.27
killsAndAssistsv3.34
majorMoneyLeadv3.40
majorMoneyDeficitv3.41
forwardPercentagev3.42
baronPowerPlaysv3.38
Game Teams Objectives Fields
idBase
typeBase
completedFirstv3.11
completionCountBase
Game Players Base Fields
idBase
nameBase
idBase
nameBase
killsBase
deathsBase
killAssistsGivenBase
netWorthBase
Game Players LOL Extension (GamePlayerStateLol)
experiencePointsBase
totalMoneyEarnedv3.2
aliveBase
currentHealthBase
maxHealthBase
currentArmorBase
respawnClockv3.3
damageDealtv3.23
damageTakenv3.23
damagePercentagev3.25
damagePerMinutev3.24
damagePerMoneyv3.26
visionScorev3.30
visionScorePerMinutev3.33
kdaRatiov3.27
killParticipationv3.35
killsAndAssistsv3.34
moneyPerMinutev3.36
moneyPercentagev3.37
forwardPercentagev3.42
Game Players Inventory Fields
idBase
nameBase
quantityBase
Game Players Objectives Fields
idBase
typeBase
completedFirstv3.11
completionCountBase

Version Notes

Why are there version differences?

GRID Esports match data is stored based on match time. Each match uses the API version's data format available at that time. When you query older matches with newer version fields, the API returns an error stating "this field requires version X.XX".

Verified 24 version breakpoints:

  • Base - Core fields supported by all matches (109 matches)
  • v3.2 - totalMoneyEarned (total gold income) (259 matches)
  • v3.3 - respawnClock (respawn countdown) (384 matches)
  • v3.7 - games.startedAt (game start time) (163 matches)
  • v3.10 - firstKill (first blood) (84 matches)
  • v3.11 - completedFirst (first objective completed) (252 matches)
  • v3.14 - series.duration (series duration) (20 matches)
  • v3.15 - games.duration (game duration) (159 matches)
  • v3.23 - damageDealt, damageTaken (damage dealt/taken)
  • v3.24 - damagePerMinute (damage per minute)
  • v3.25 - damagePercentage (damage share, players only)
  • v3.26 - damagePerMoney (damage per gold)
  • v3.27 - kdaRatio (KDA ratio)
  • v3.28 - moneyDifference (gold difference)
  • v3.30 - visionScore (vision score) (79 matches)
  • v3.33 - visionScorePerMinute (vision score per minute)
  • v3.34 - killsAndAssists (kills + assists)
  • v3.35 - killParticipation (kill participation rate) (84 matches)
  • v3.36 - moneyPerMinute (gold per minute)
  • v3.37 - moneyPercentage (gold share)
  • v3.38 - baronPowerPlays (baron power plays) (209 matches)
  • v3.40 - majorMoneyLead (major gold lead)
  • v3.41 - majorMoneyDeficit (major gold deficit)
  • v3.42 - forwardPercentage (forward percentage) (1584 matches)