Update a match (v2)
POST/v2/matches/{matchId}
const url = 'https://api.ligr.live/rest/v2/matches/1';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name":"example","venueId":1,"competitionId":1,"date":"2026-04-15T12:00:00Z","competitorsType":"singles","competitors":[{"entityId":1,"entityType":"team","meta":{"isHome":true}}],"description":"example","config":"example","homeTeamKitKey":"home","awayTeamKitKey":"home","homeTeamFormation":"example","awayTeamFormation":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.ligr.live/rest/v2/matches/1 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "example", "venueId": 1, "competitionId": 1, "date": "2026-04-15T12:00:00Z", "competitorsType": "singles", "competitors": [ { "entityId": 1, "entityType": "team", "meta": { "isHome": true } } ], "description": "example", "config": "example", "homeTeamKitKey": "home", "awayTeamKitKey": "home", "homeTeamFormation": "example", "awayTeamFormation": "example" }'Update an existing match.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Entity identifier
Request Bodyrequired
Section titled “Request Bodyrequired”The match properties to update
object
Match name
Entity identifier
Entity identifier
The match format: singles, doubles, teams or group. It is one value for the match.
Each row in competitors has its own entityType. For example, a doubles match has
competitorsType: doubles and four entityType: player rows. A group match has player rows.
object
Entity identifier
The kind of one competitor row: team or player. A teams match has team rows.
A singles, doubles or group match has player rows.
object
Free text about the match.
Match rules for this match only. The value applies onto the stored match config, or onto the
competition matchConfig when the match has none: a key that you omit keeps its value. Nested
objects, arrays and null work as on POST /v2/matches. The API checks rules and, for tennis,
the scoring. A value that fails the check returns 400 with the reason, and nothing changes.
LIGR then rebuilds the match summary from its facts with the new rules.
Football only. The formation of the home team as an Opta code without dashes, for example 442,
433 or 4231. Send null to remove it.
Football only. The formation of the away team as an Opta code without dashes, for example 442,
433 or 4231. Send null to remove it.
Responses
Section titled “Responses”No content
Request is invalid
object
object
Examplegenerated
{ "message": "example", "details": { "additionalProperty": "example" }}Missing or invalid api key
object
Examplegenerated
{ "message": "example"}Api key provides insufficient access for the request
object
Examplegenerated
{ "message": "example"}Match not found
object
Examplegenerated
{ "message": "example"}Organization has made too many requests
object
Examplegenerated
{ "message": "example"}An unexpected error has occured. If problems persist please contact support
object
Examplegenerated
{ "message": "example"}