Skip to main content

Competition Types & Entities


(Enum) Competition Type​

'classic', 'team'

(Enum) Competition Status​

'upcoming', 'ongoing', 'finished'

(Enum) Competition CSV Table Type​

'team', 'teams', 'participants'

(Object) Competition Progress​

FieldTypeDescription
startintegerA player's start value for the competition's metric.
endintegerA player's end value for the competition's metric.
gainedintegerA player's gained value for the competition's metric.

(Object) Competition Levels Progress​

FieldTypeDescription
startintegerA player's start level for the competition's metric.
endintegerA player's end level for the competition's metric.
gainedintegerA player's gained levels for the competition's metric.

(Object) Competition​

FieldTypeDescription
idintegerThe competition's unique ID.
titlestringThe competition's title.
metricMetricThe competition's metric.
typeCompetitionTypeThe competition's type.
startsAtdateThe competition's start date.
endsAtdateThe competition's end date.
groupIdinteger?The competition's host group ID.
scoreintegerThe competition's global ranking score.
createdAtdateThe competition's creation date.
updatedAtdateThe competition's last modification date.
participantCountnumberThe competition's total number of participants.
groupGroupThe competition's host group.

(Object) Participation​

FieldTypeDescription
playerIdintegerThe player's ID.
competitionIdintegerThe competition's ID.
teamNamestring?The name of the team the player is in. (Only applicable to team competitions)
createdAtdateThe date at which the player was added as a participant to the competition.
updatedAtdateThe date at which the participation was updated.

(Object) Competition Participation​

Returned in competition-centric endpoints.

extends Participation

FieldTypeDescription
playerPlayerThe participation's player.

(Object) Player Participation​

Returned in player-centric endpoints.

extends Participation

FieldTypeDescription
competitionCompetitionThe competition the player is competing in.

(Object) Player Competition Standing​

extends PlayerParticipation

FieldTypeDescription
progressCompetitionProgressThe player's progress in the competition.
levelsCompetitionLevelProgress?The player's levels progress in the competition. (Only exists in skilling competitions)
ranknumberThe player's rank in the competition.

(Object) Competition Participation Details​

extends CompetitionParticipation

FieldTypeDescription
progressCompetitionProgressThe player's progress in the competition.
levelsCompetitionLevelProgress?The player's levels progress in the competition. (Only exists in skilling competitions)

(Object) Competition Details​

extends Competition

FieldTypeDescription
participationsCompetitionParticipationDetailsThe competition's participants, and all their progress.

(Object) Competition History Datapoint​

FieldTypeDescription
valuenumberThe player's value for the competition metric, at a specific point in time.
datedateThe date at which the datapoint was recorded.

(Object) Top 5 Progress Result​

FieldTypeDescription
playerPlayerThe participant.
historyCompetitionHistoryDataPointThe participant's history throughout the competition.

(Object) Team​

FieldTypeDescription
namestringThe team's name.
participantsstring[]The team's participants' usernames.

(Object) Competition With Participations​

extends Competition

FieldTypeDescription
participationsCompetitionParticipation[]The competition's participants.