v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB

League: Scores

Submit one league match map score

Submits the score for one map in a league match; league admin scores are auto-confirmed. Requires a personal or developer API key whose owner is currently a league ADMIN of the league in the path, with the league scores capability enabled on the key. League API access is gated at api_pro on the league owner's plan.

post/leagues/{identifier}/matches/{matchId}/scores/{mapIndex}

Path parameters

identifierstring required

League slug.

matchIdstring required

Match ID.

mapIndexstring required

Zero-based index of the map within the series.

Request body

mapIdstring required

Identifier of the map that was played.

creatorTeamScoreinteger required

Score for the creator team (integer, 0-1000).

opponentTeamScoreinteger required

Score for the opponent (accepted) team (integer, 0-1000).

screenshotUrlsstring[]

Optional external screenshot URLs supporting the reported score. Each must be a public https URL. Prefer screenshotStorageIds (validated blobs) where possible.

screenshotStorageIdsstring[]

Optional storage IDs for screenshots uploaded via POST /uploads/image-url. Preferred over screenshotUrls: each is validated (size, content-type, ownership) and resolved to a URL server-side.

playerStatsobject

Optional per-player stats keyed by user ID.

Response

The map score was submitted and confirmed.

successtrue required

mapIndexinteger required

Index of the map that was scored.

scoreStatusstring required

Confirmation state, always "CONFIRMED" on success.