Sign in
League: Scores

Update a league match's lifecycle status

Transitions a league match between lifecycle states. 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.

patch/leagues/{identifier}/matches/{matchId}/status

Path parameters

identifierstring required

League slug.

League slug.

matchIdstring required

Match ID.

Match ID.

Request body

statusstring required

Target status. Allowed league transitions: READY -> IN_PROGRESS|CANCELLED, ACCEPTED -> CANCELLED. COMPLETED is not accepted directly; matches complete automatically once scores are confirmed.

Response

The league match status was transitioned successfully.

successtrue required
matchIdstring required

ID of the updated match.

previousStatusstring required

Match status before the transition.

newStatusstring required

Match status after the transition.

timestampstring required

Server response time (ISO 8601).

Changes

Changed in 3 of the 21 revisions of this API.13