Tactica API
The everything API for football data
Version: 1.0.0
BasePath:/IANBROTHERTON90_1/Tactika/1.0.0
All rights reserved
http://apache.org/licenses/LICENSE-2.0.html
Access
[ Jump to Models ]
Table of Contents
Get Commentary (commentaryGet)
Fetches commentary for a match
Return type
Example data
Content-Type: application/json
{
"matchInfo" : {
"date" : "2024-05-13T00:00:00Z",
"venue" : {
"neutral" : "no",
"id" : "28byqkvkzhdjy48okwrqyu2mp",
"shortName" : "Villa Park",
"longName" : "Villa Park"
},
"coverageLevel" : "15",
"contestant" : [ {
"country" : {
"name" : "England",
"id" : "1fk5l4hkqk12i7zske6mcqju6"
},
"code" : "AVL",
"name" : "Aston Villa",
"id" : "b496gs285it6bheuikox6z9mj",
"position" : "home",
"officialName" : "Aston Villa FC",
"shortName" : "Aston Villa"
}, {
"country" : {
"name" : "England",
"id" : "1fk5l4hkqk12i7zske6mcqju6"
},
"code" : "AVL",
"name" : "Aston Villa",
"id" : "b496gs285it6bheuikox6z9mj",
"position" : "home",
"officialName" : "Aston Villa FC",
"shortName" : "Aston Villa"
} ],
"description" : "Aston Villa vs Liverpool",
"competition" : {
"country" : {
"name" : "England",
"id" : "1fk5l4hkqk12i7zske6mcqju6"
},
"competitionCode" : "EPL",
"name" : "Premier League",
"competitionFormat" : "Domestic league",
"id" : "2kwbbcootiqqgmrzs6o5inle5",
"knownName" : "English Premier League"
},
"id" : "emmzeapkmoejx2suwdcgu0x78"
},
"messages" : [ {
"language" : "en-gb",
"message" : [ {
"teamRef1" : "b496gs285it6bheuikox6z9mj",
"period" : "2",
"playerRef1" : "dxze3b3fsfl814bjcs7q6wcet",
"teamRef2" : "c8h9bw1l82s06h77xxrelzhur",
"comment" : "Goal! Aston Villa 3, Liverpool 3.",
"id" : "2687196657",
"lastModified" : "2024-05-14T04:02:20Z",
"time" : "88'",
"type" : "goal",
"minute" : "87",
"second" : "45",
"timestamp" : "2024-05-13T20:49:40Z"
}, {
"teamRef1" : "b496gs285it6bheuikox6z9mj",
"period" : "2",
"playerRef1" : "dxze3b3fsfl814bjcs7q6wcet",
"teamRef2" : "c8h9bw1l82s06h77xxrelzhur",
"comment" : "Goal! Aston Villa 3, Liverpool 3.",
"id" : "2687196657",
"lastModified" : "2024-05-14T04:02:20Z",
"time" : "88'",
"type" : "goal",
"minute" : "87",
"second" : "45",
"timestamp" : "2024-05-13T20:49:40Z"
} ]
}, {
"language" : "en-gb",
"message" : [ {
"teamRef1" : "b496gs285it6bheuikox6z9mj",
"period" : "2",
"playerRef1" : "dxze3b3fsfl814bjcs7q6wcet",
"teamRef2" : "c8h9bw1l82s06h77xxrelzhur",
"comment" : "Goal! Aston Villa 3, Liverpool 3.",
"id" : "2687196657",
"lastModified" : "2024-05-14T04:02:20Z",
"time" : "88'",
"type" : "goal",
"minute" : "87",
"second" : "45",
"timestamp" : "2024-05-13T20:49:40Z"
}, {
"teamRef1" : "b496gs285it6bheuikox6z9mj",
"period" : "2",
"playerRef1" : "dxze3b3fsfl814bjcs7q6wcet",
"teamRef2" : "c8h9bw1l82s06h77xxrelzhur",
"comment" : "Goal! Aston Villa 3, Liverpool 3.",
"id" : "2687196657",
"lastModified" : "2024-05-14T04:02:20Z",
"time" : "88'",
"type" : "goal",
"minute" : "87",
"second" : "45",
"timestamp" : "2024-05-13T20:49:40Z"
} ]
} ]
}
Produces
This API call produces the following media types according to the
request header; the media type will be
conveyed by the response header.
Responses
200
Commentary details
inline_response_200_6
400
Bad Request. Missing or invalid match ID.
500
Internal Server Error.
Retrieve live data and match details (expectedGoalsGet)
Fetch detailed live data, events, lineup, and metadata for a specific
match.
Query parameters
matchId (required)
Query Parameter — The unique
identifier for the match.
Return type
Example data
Content-Type: application/json
{
"matchInfo" : {
"date" : "2000-01-23",
"venue" : {
"neutral" : "no",
"id" : "28byqkvkzhdjy48okwrqyu2mp",
"shortName" : "Villa Park",
"longName" : "Villa Park"
},
"scores" : {
"ht" : {
"away" : 2,
"home" : 1
},
"ft" : {
"away" : 3,
"home" : 3
}
},
"contestant" : [ {
"country" : {
"name" : "England",
"id" : "1fk5l4hkqk12i7zske6mcqju6"
},
"code" : "AVL",
"name" : "Aston Villa",
"id" : "b496gs285it6bheuikox6z9mj",
"position" : "home",
"officialName" : "Aston Villa FC",
"shortName" : "Aston Villa"
}, {
"country" : {
"name" : "England",
"id" : "1fk5l4hkqk12i7zske6mcqju6"
},
"code" : "AVL",
"name" : "Aston Villa",
"id" : "b496gs285it6bheuikox6z9mj",
"position" : "home",
"officialName" : "Aston Villa FC",
"shortName" : "Aston Villa"
} ],
"description" : "Aston Villa vs Liverpool",
"competition" : {
"country" : {
"name" : "England",
"id" : "1fk5l4hkqk12i7zske6mcqju6"
},
"competitionCode" : "EPL",
"name" : "Premier League",
"competitionFormat" : "Domestic league",
"id" : "2kwbbcootiqqgmrzs6o5inle5",
"knownName" : "English Premier League"
},
"id" : "emmzeapkmoejx2suwdcgu0x78"
},
"liveData" : {
"lineUp" : [ {
"contestantId" : "b496gs285it6bheuikox6z9mj",
"teamOfficial" : [ {
"firstName" : "Jürgen Norbert",
"lastName" : "Klopp",
"id" : "9yw8otph5rger7665zx1yqrpx",
"type" : "manager"
}, {
"firstName" : "Jürgen Norbert",
"lastName" : "Klopp",
"id" : "9yw8otph5rger7665zx1yqrpx",
"type" : "manager"
} ],
"player" : [ {
"firstName" : "Damián Emiliano",
"lastName" : "Martínez Romero",
"shortFirstName" : "Emiliano",
"stat" : [ [ {
"type" : "minsPlayed",
"value" : "90"
}, {
"type" : "ownGoals",
"value" : "1"
}, {
"type" : "touches",
"value" : "55"
}, {
"type" : "expectedGoalsConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsNonpenaltyConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsontargetConceded",
"value" : "2.1959"
}, {
"type" : "expectedAssists",
"value" : "0.00012186"
}, {
"type" : "expectedAssistsSetplay",
"value" : "5.713E-5"
}, {
"type" : "expectedAssistsOpenplay",
"value" : "6.473E-5"
}, {
"type" : "shotOffTarget",
"value" : "1"
}, {
"type" : "touchesInOppBox",
"value" : "1"
}, {
"type" : "totalAttAssist",
"value" : "1"
}, {
"type" : "totalScoringAtt",
"value" : 1
}, {
"type" : "attAssistSetplay",
"value" : "1"
}, {
"type" : "attObxCentre",
"value" : "1"
}, {
"type" : "expectedGoals",
"value" : "0.0083"
}, {
"type" : "expectedGoalsNonpenalty",
"value" : "0.0083"
}, {
"type" : "expectedGoalsSetplay",
"value" : "0.0083"
} ], [ {
"type" : "minsPlayed",
"value" : "90"
}, {
"type" : "ownGoals",
"value" : "1"
}, {
"type" : "touches",
"value" : "55"
}, {
"type" : "expectedGoalsConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsNonpenaltyConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsontargetConceded",
"value" : "2.1959"
}, {
"type" : "expectedAssists",
"value" : "0.00012186"
}, {
"type" : "expectedAssistsSetplay",
"value" : "5.713E-5"
}, {
"type" : "expectedAssistsOpenplay",
"value" : "6.473E-5"
}, {
"type" : "shotOffTarget",
"value" : "1"
}, {
"type" : "touchesInOppBox",
"value" : "1"
}, {
"type" : "totalAttAssist",
"value" : "1"
}, {
"type" : "totalScoringAtt",
"value" : 1
}, {
"type" : "attAssistSetplay",
"value" : "1"
}, {
"type" : "attObxCentre",
"value" : "1"
}, {
"type" : "expectedGoals",
"value" : "0.0083"
}, {
"type" : "expectedGoalsNonpenalty",
"value" : "0.0083"
}, {
"type" : "expectedGoalsSetplay",
"value" : "0.0083"
} ] ],
"shirtNumber" : 1,
"matchName" : "E. Martínez",
"positionSide" : "Centre",
"position" : "Goalkeeper",
"shortLastName" : "Martínez",
"playerId" : "3zl1q2gk6tdmzirsyfgm38no5"
}, {
"firstName" : "Damián Emiliano",
"lastName" : "Martínez Romero",
"shortFirstName" : "Emiliano",
"stat" : [ [ {
"type" : "minsPlayed",
"value" : "90"
}, {
"type" : "ownGoals",
"value" : "1"
}, {
"type" : "touches",
"value" : "55"
}, {
"type" : "expectedGoalsConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsNonpenaltyConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsontargetConceded",
"value" : "2.1959"
}, {
"type" : "expectedAssists",
"value" : "0.00012186"
}, {
"type" : "expectedAssistsSetplay",
"value" : "5.713E-5"
}, {
"type" : "expectedAssistsOpenplay",
"value" : "6.473E-5"
}, {
"type" : "shotOffTarget",
"value" : "1"
}, {
"type" : "touchesInOppBox",
"value" : "1"
}, {
"type" : "totalAttAssist",
"value" : "1"
}, {
"type" : "totalScoringAtt",
"value" : 1
}, {
"type" : "attAssistSetplay",
"value" : "1"
}, {
"type" : "attObxCentre",
"value" : "1"
}, {
"type" : "expectedGoals",
"value" : "0.0083"
}, {
"type" : "expectedGoalsNonpenalty",
"value" : "0.0083"
}, {
"type" : "expectedGoalsSetplay",
"value" : "0.0083"
} ], [ {
"type" : "minsPlayed",
"value" : "90"
}, {
"type" : "ownGoals",
"value" : "1"
}, {
"type" : "touches",
"value" : "55"
}, {
"type" : "expectedGoalsConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsNonpenaltyConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsontargetConceded",
"value" : "2.1959"
}, {
"type" : "expectedAssists",
"value" : "0.00012186"
}, {
"type" : "expectedAssistsSetplay",
"value" : "5.713E-5"
}, {
"type" : "expectedAssistsOpenplay",
"value" : "6.473E-5"
}, {
"type" : "shotOffTarget",
"value" : "1"
}, {
"type" : "touchesInOppBox",
"value" : "1"
}, {
"type" : "totalAttAssist",
"value" : "1"
}, {
"type" : "totalScoringAtt",
"value" : 1
}, {
"type" : "attAssistSetplay",
"value" : "1"
}, {
"type" : "attObxCentre",
"value" : "1"
}, {
"type" : "expectedGoals",
"value" : "0.0083"
}, {
"type" : "expectedGoalsNonpenalty",
"value" : "0.0083"
}, {
"type" : "expectedGoalsSetplay",
"value" : "0.0083"
} ] ],
"shirtNumber" : 1,
"matchName" : "E. Martínez",
"positionSide" : "Centre",
"position" : "Goalkeeper",
"shortLastName" : "Martínez",
"playerId" : "3zl1q2gk6tdmzirsyfgm38no5"
} ]
}, {
"contestantId" : "b496gs285it6bheuikox6z9mj",
"teamOfficial" : [ {
"firstName" : "Jürgen Norbert",
"lastName" : "Klopp",
"id" : "9yw8otph5rger7665zx1yqrpx",
"type" : "manager"
}, {
"firstName" : "Jürgen Norbert",
"lastName" : "Klopp",
"id" : "9yw8otph5rger7665zx1yqrpx",
"type" : "manager"
} ],
"player" : [ {
"firstName" : "Damián Emiliano",
"lastName" : "Martínez Romero",
"shortFirstName" : "Emiliano",
"stat" : [ [ {
"type" : "minsPlayed",
"value" : "90"
}, {
"type" : "ownGoals",
"value" : "1"
}, {
"type" : "touches",
"value" : "55"
}, {
"type" : "expectedGoalsConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsNonpenaltyConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsontargetConceded",
"value" : "2.1959"
}, {
"type" : "expectedAssists",
"value" : "0.00012186"
}, {
"type" : "expectedAssistsSetplay",
"value" : "5.713E-5"
}, {
"type" : "expectedAssistsOpenplay",
"value" : "6.473E-5"
}, {
"type" : "shotOffTarget",
"value" : "1"
}, {
"type" : "touchesInOppBox",
"value" : "1"
}, {
"type" : "totalAttAssist",
"value" : "1"
}, {
"type" : "totalScoringAtt",
"value" : 1
}, {
"type" : "attAssistSetplay",
"value" : "1"
}, {
"type" : "attObxCentre",
"value" : "1"
}, {
"type" : "expectedGoals",
"value" : "0.0083"
}, {
"type" : "expectedGoalsNonpenalty",
"value" : "0.0083"
}, {
"type" : "expectedGoalsSetplay",
"value" : "0.0083"
} ], [ {
"type" : "minsPlayed",
"value" : "90"
}, {
"type" : "ownGoals",
"value" : "1"
}, {
"type" : "touches",
"value" : "55"
}, {
"type" : "expectedGoalsConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsNonpenaltyConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsontargetConceded",
"value" : "2.1959"
}, {
"type" : "expectedAssists",
"value" : "0.00012186"
}, {
"type" : "expectedAssistsSetplay",
"value" : "5.713E-5"
}, {
"type" : "expectedAssistsOpenplay",
"value" : "6.473E-5"
}, {
"type" : "shotOffTarget",
"value" : "1"
}, {
"type" : "touchesInOppBox",
"value" : "1"
}, {
"type" : "totalAttAssist",
"value" : "1"
}, {
"type" : "totalScoringAtt",
"value" : 1
}, {
"type" : "attAssistSetplay",
"value" : "1"
}, {
"type" : "attObxCentre",
"value" : "1"
}, {
"type" : "expectedGoals",
"value" : "0.0083"
}, {
"type" : "expectedGoalsNonpenalty",
"value" : "0.0083"
}, {
"type" : "expectedGoalsSetplay",
"value" : "0.0083"
} ] ],
"shirtNumber" : 1,
"matchName" : "E. Martínez",
"positionSide" : "Centre",
"position" : "Goalkeeper",
"shortLastName" : "Martínez",
"playerId" : "3zl1q2gk6tdmzirsyfgm38no5"
}, {
"firstName" : "Damián Emiliano",
"lastName" : "Martínez Romero",
"shortFirstName" : "Emiliano",
"stat" : [ [ {
"type" : "minsPlayed",
"value" : "90"
}, {
"type" : "ownGoals",
"value" : "1"
}, {
"type" : "touches",
"value" : "55"
}, {
"type" : "expectedGoalsConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsNonpenaltyConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsontargetConceded",
"value" : "2.1959"
}, {
"type" : "expectedAssists",
"value" : "0.00012186"
}, {
"type" : "expectedAssistsSetplay",
"value" : "5.713E-5"
}, {
"type" : "expectedAssistsOpenplay",
"value" : "6.473E-5"
}, {
"type" : "shotOffTarget",
"value" : "1"
}, {
"type" : "touchesInOppBox",
"value" : "1"
}, {
"type" : "totalAttAssist",
"value" : "1"
}, {
"type" : "totalScoringAtt",
"value" : 1
}, {
"type" : "attAssistSetplay",
"value" : "1"
}, {
"type" : "attObxCentre",
"value" : "1"
}, {
"type" : "expectedGoals",
"value" : "0.0083"
}, {
"type" : "expectedGoalsNonpenalty",
"value" : "0.0083"
}, {
"type" : "expectedGoalsSetplay",
"value" : "0.0083"
} ], [ {
"type" : "minsPlayed",
"value" : "90"
}, {
"type" : "ownGoals",
"value" : "1"
}, {
"type" : "touches",
"value" : "55"
}, {
"type" : "expectedGoalsConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsNonpenaltyConceded",
"value" : "1.7482"
}, {
"type" : "expectedGoalsontargetConceded",
"value" : "2.1959"
}, {
"type" : "expectedAssists",
"value" : "0.00012186"
}, {
"type" : "expectedAssistsSetplay",
"value" : "5.713E-5"
}, {
"type" : "expectedAssistsOpenplay",
"value" : "6.473E-5"
}, {
"type" : "shotOffTarget",
"value" : "1"
}, {
"type" : "touchesInOppBox",
"value" : "1"
}, {
"type" : "totalAttAssist",
"value" : "1"
}, {
"type" : "totalScoringAtt",
"value" : 1
}, {
"type" : "attAssistSetplay",
"value" : "1"
}, {
"type" : "attObxCentre",
"value" : "1"
}, {
"type" : "expectedGoals",
"value" : "0.0083"
}, {
"type" : "expectedGoalsNonpenalty",
"value" : "0.0083"
}, {
"type" : "expectedGoalsSetplay",
"value" : "0.0083"
} ] ],
"shirtNumber" : 1,
"matchName" : "E. Martínez",
"positionSide" : "Centre",
"position" : "Goalkeeper",
"shortLastName" : "Martínez",
"playerId" : "3zl1q2gk6tdmzirsyfgm38no5"
} ]
} ],
"event" : [ {
"eventId" : 10,
"periodId" : 1,
"contestantId" : "b496gs285it6bheuikox6z9mj",
"playerName" : "E. Martínez",
"timeSec" : 24,
"timeMin" : 3,
"timeStamp" : "2024-05-13T19:03:52.135Z",
"qualifier" : [ {
"qualifierId" : 22,
"id" : 5028622733
}, {
"qualifierId" : 22,
"id" : 5028622733
} ],
"x" : 88.2,
"y" : 32,
"typeId" : 15,
"id" : 2687159747,
"lastModified" : "2024-05-20T08:55:58Z",
"outcome" : 1,
"playerId" : "3zl1q2gk6tdmzirsyfgm38no5"
}, {
"eventId" : 10,
"periodId" : 1,
"contestantId" : "b496gs285it6bheuikox6z9mj",
"playerName" : "E. Martínez",
"timeSec" : 24,
"timeMin" : 3,
"timeStamp" : "2024-05-13T19:03:52.135Z",
"qualifier" : [ {
"qualifierId" : 22,
"id" : 5028622733
}, {
"qualifierId" : 22,
"id" : 5028622733
} ],
"x" : 88.2,
"y" : 32,
"typeId" : 15,
"id" : 2687159747,
"lastModified" : "2024-05-20T08:55:58Z",
"outcome" : 1,
"playerId" : "3zl1q2gk6tdmzirsyfgm38no5"
} ]
}
}
Produces
This API call produces the following media types according to the
request header; the media type will be
conveyed by the response header.
Responses
200
Successful response with live match data and details.
inline_response_200_8
Get Match Data (matchDataGet)
Returns a summary of key metrics for a resulted game. Similar to
/matchEvent and for use where detail(s) on a per-incident
basis aren't required.
Query parameters
eventId (required)
Query Parameter — The event ID
live (optional)
Query Parameter — Live status
lineups (optional)
Query Parameter — Include
lineups
Return type
Example data
Content-Type: application/json
{
"match" : [ {
"matchInfo" : {
"date" : "2000-01-23",
"venue" : {
"neutral" : "neutral",
"id" : "id",
"shortName" : "shortName",
"longName" : "longName"
},
"week" : "week",
"var" : "var",
"coverageLevel" : "coverageLevel",
"ruleset" : {
"name" : "name",
"id" : "id"
},
"description" : "description",
"competition" : {
"country" : {
"name" : "name",
"id" : "id"
},
"competitionCode" : "competitionCode",
"name" : "name",
"competitionFormat" : "competitionFormat",
"id" : "id",
"knownName" : "knownName"
},
"numberOfPeriods" : 8,
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"localTime" : "localTime",
"stage" : {
"formatId" : "formatId",
"endDate" : "2000-01-23",
"name" : "name",
"id" : "id",
"startDate" : "2000-01-23"
},
"contestant" : [ {
"country" : {
"name" : "name",
"id" : "id"
},
"code" : "code",
"name" : "name",
"id" : "id",
"position" : "position",
"officialName" : "officialName",
"shortName" : "shortName"
}, {
"country" : {
"name" : "name",
"id" : "id"
},
"code" : "code",
"name" : "name",
"id" : "id",
"position" : "position",
"officialName" : "officialName",
"shortName" : "shortName"
} ],
"periodLength" : 9,
"id" : "id",
"localDate" : "2000-01-23",
"time" : "time",
"tournamentCalendar" : {
"endDate" : "2000-01-23",
"name" : "name",
"id" : "id",
"startDate" : "2000-01-23"
},
"sport" : {
"name" : "name",
"id" : "id"
}
},
"liveData" : {
"matchDetailsExtra" : {
"matchOfficial" : [ {
"firstName" : "firstName",
"lastName" : "lastName",
"shortFirstName" : "shortFirstName",
"id" : "id",
"shortLastName" : "shortLastName",
"type" : "type"
}, {
"firstName" : "firstName",
"lastName" : "lastName",
"shortFirstName" : "shortFirstName",
"id" : "id",
"shortLastName" : "shortLastName",
"type" : "type"
} ],
"attendance" : "attendance"
},
"goal" : [ {
"periodId" : 7,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"homeScore" : 2,
"scorerName" : "scorerName",
"assistPlayerName" : "assistPlayerName",
"optaEventId" : "optaEventId",
"scorerId" : "scorerId",
"timeMin" : 9,
"type" : "type",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"awayScore" : 5,
"assistPlayerId" : "assistPlayerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
}, {
"periodId" : 7,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"homeScore" : 2,
"scorerName" : "scorerName",
"assistPlayerName" : "assistPlayerName",
"optaEventId" : "optaEventId",
"scorerId" : "scorerId",
"timeMin" : 9,
"type" : "type",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"awayScore" : 5,
"assistPlayerId" : "assistPlayerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
} ],
"VAR" : [ {
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 0,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"decision" : "decision",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 6,
"type" : "type",
"outcome" : "outcome",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
}, {
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 0,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"decision" : "decision",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 6,
"type" : "type",
"outcome" : "outcome",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
} ],
"matchDetails" : {
"periodId" : 1,
"matchLengthMin" : 3,
"matchStatus" : "matchStatus",
"period" : [ {
"announcedInjuryTime" : 4,
"lengthSec" : 1,
"lengthMin" : 1,
"start" : "2000-01-23T04:56:07.000+00:00",
"end" : "2000-01-23T04:56:07.000+00:00",
"id" : 7
}, {
"announcedInjuryTime" : 4,
"lengthSec" : 1,
"lengthMin" : 1,
"start" : "2000-01-23T04:56:07.000+00:00",
"end" : "2000-01-23T04:56:07.000+00:00",
"id" : 7
} ],
"matchLengthSec" : 2,
"winner" : "winner",
"scores" : {
"total" : {
"away" : 5,
"home" : 9
},
"ht" : {
"away" : 1,
"home" : 4
},
"ft" : {
"away" : 6,
"home" : 7
}
}
},
"card" : [ {
"cardReason" : "cardReason",
"periodId" : 1,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 5,
"officialName" : "officialName",
"type" : "type",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"teamOfficialId" : "teamOfficialId",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
}, {
"cardReason" : "cardReason",
"periodId" : 1,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 5,
"officialName" : "officialName",
"type" : "type",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"teamOfficialId" : "teamOfficialId",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
} ],
"substitute" : [ {
"subReason" : "subReason",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 9,
"playerOnId" : "playerOnId",
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"playerOffId" : "playerOffId",
"playerOnName" : "playerOnName",
"timeMin" : 6,
"playerOffName" : "playerOffName",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
}, {
"subReason" : "subReason",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 9,
"playerOnId" : "playerOnId",
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"playerOffId" : "playerOffId",
"playerOnName" : "playerOnName",
"timeMin" : 6,
"playerOffName" : "playerOffName",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
} ]
}
}, {
"matchInfo" : {
"date" : "2000-01-23",
"venue" : {
"neutral" : "neutral",
"id" : "id",
"shortName" : "shortName",
"longName" : "longName"
},
"week" : "week",
"var" : "var",
"coverageLevel" : "coverageLevel",
"ruleset" : {
"name" : "name",
"id" : "id"
},
"description" : "description",
"competition" : {
"country" : {
"name" : "name",
"id" : "id"
},
"competitionCode" : "competitionCode",
"name" : "name",
"competitionFormat" : "competitionFormat",
"id" : "id",
"knownName" : "knownName"
},
"numberOfPeriods" : 8,
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"localTime" : "localTime",
"stage" : {
"formatId" : "formatId",
"endDate" : "2000-01-23",
"name" : "name",
"id" : "id",
"startDate" : "2000-01-23"
},
"contestant" : [ {
"country" : {
"name" : "name",
"id" : "id"
},
"code" : "code",
"name" : "name",
"id" : "id",
"position" : "position",
"officialName" : "officialName",
"shortName" : "shortName"
}, {
"country" : {
"name" : "name",
"id" : "id"
},
"code" : "code",
"name" : "name",
"id" : "id",
"position" : "position",
"officialName" : "officialName",
"shortName" : "shortName"
} ],
"periodLength" : 9,
"id" : "id",
"localDate" : "2000-01-23",
"time" : "time",
"tournamentCalendar" : {
"endDate" : "2000-01-23",
"name" : "name",
"id" : "id",
"startDate" : "2000-01-23"
},
"sport" : {
"name" : "name",
"id" : "id"
}
},
"liveData" : {
"matchDetailsExtra" : {
"matchOfficial" : [ {
"firstName" : "firstName",
"lastName" : "lastName",
"shortFirstName" : "shortFirstName",
"id" : "id",
"shortLastName" : "shortLastName",
"type" : "type"
}, {
"firstName" : "firstName",
"lastName" : "lastName",
"shortFirstName" : "shortFirstName",
"id" : "id",
"shortLastName" : "shortLastName",
"type" : "type"
} ],
"attendance" : "attendance"
},
"goal" : [ {
"periodId" : 7,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"homeScore" : 2,
"scorerName" : "scorerName",
"assistPlayerName" : "assistPlayerName",
"optaEventId" : "optaEventId",
"scorerId" : "scorerId",
"timeMin" : 9,
"type" : "type",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"awayScore" : 5,
"assistPlayerId" : "assistPlayerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
}, {
"periodId" : 7,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"homeScore" : 2,
"scorerName" : "scorerName",
"assistPlayerName" : "assistPlayerName",
"optaEventId" : "optaEventId",
"scorerId" : "scorerId",
"timeMin" : 9,
"type" : "type",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"awayScore" : 5,
"assistPlayerId" : "assistPlayerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
} ],
"VAR" : [ {
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 0,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"decision" : "decision",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 6,
"type" : "type",
"outcome" : "outcome",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
}, {
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 0,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"decision" : "decision",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 6,
"type" : "type",
"outcome" : "outcome",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
} ],
"matchDetails" : {
"periodId" : 1,
"matchLengthMin" : 3,
"matchStatus" : "matchStatus",
"period" : [ {
"announcedInjuryTime" : 4,
"lengthSec" : 1,
"lengthMin" : 1,
"start" : "2000-01-23T04:56:07.000+00:00",
"end" : "2000-01-23T04:56:07.000+00:00",
"id" : 7
}, {
"announcedInjuryTime" : 4,
"lengthSec" : 1,
"lengthMin" : 1,
"start" : "2000-01-23T04:56:07.000+00:00",
"end" : "2000-01-23T04:56:07.000+00:00",
"id" : 7
} ],
"matchLengthSec" : 2,
"winner" : "winner",
"scores" : {
"total" : {
"away" : 5,
"home" : 9
},
"ht" : {
"away" : 1,
"home" : 4
},
"ft" : {
"away" : 6,
"home" : 7
}
}
},
"card" : [ {
"cardReason" : "cardReason",
"periodId" : 1,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 5,
"officialName" : "officialName",
"type" : "type",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"teamOfficialId" : "teamOfficialId",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
}, {
"cardReason" : "cardReason",
"periodId" : 1,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 5,
"officialName" : "officialName",
"type" : "type",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"teamOfficialId" : "teamOfficialId",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
} ],
"substitute" : [ {
"subReason" : "subReason",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 9,
"playerOnId" : "playerOnId",
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"playerOffId" : "playerOffId",
"playerOnName" : "playerOnName",
"timeMin" : 6,
"playerOffName" : "playerOffName",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
}, {
"subReason" : "subReason",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 9,
"playerOnId" : "playerOnId",
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"playerOffId" : "playerOffId",
"playerOnName" : "playerOnName",
"timeMin" : 6,
"playerOffName" : "playerOffName",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
} ]
}
} ]
}
Produces
This API call produces the following media types according to the
request header; the media type will be
conveyed by the response header.
Responses
200
Match data details
inline_response_200_3
Get Match Event (matchEventGet)
Returns liveData and matchInfo, for use
post-match & inplay to register inplay incident data where users
allow for latency in favour of increased accuracy.
Query parameters
fixtureId (required)
Query Parameter — The fixture ID
live (optional)
Query Parameter — Live status
lineups (optional)
Query Parameter — Include
lineups
Return type
Example data
Content-Type: application/json
{
"matchInfo" : {
"date" : "2000-01-23",
"venue" : {
"neutral" : "neutral",
"id" : "id",
"shortName" : "shortName",
"longName" : "longName"
},
"week" : "week",
"var" : "var",
"coverageLevel" : "coverageLevel",
"ruleset" : {
"name" : "name",
"id" : "id"
},
"description" : "description",
"competition" : {
"country" : {
"name" : "name",
"id" : "id"
},
"competitionCode" : "competitionCode",
"name" : "name",
"competitionFormat" : "competitionFormat",
"id" : "id",
"knownName" : "knownName"
},
"numberOfPeriods" : 9,
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"localTime" : "localTime",
"stage" : {
"formatId" : "formatId",
"endDate" : "2000-01-23",
"name" : "name",
"id" : "id",
"startDate" : "2000-01-23"
},
"contestant" : [ {
"country" : {
"name" : "name",
"id" : "id"
},
"code" : "code",
"name" : "name",
"id" : "id",
"position" : "position",
"officialName" : "officialName",
"shortName" : "shortName"
}, {
"country" : {
"name" : "name",
"id" : "id"
},
"code" : "code",
"name" : "name",
"id" : "id",
"position" : "position",
"officialName" : "officialName",
"shortName" : "shortName"
} ],
"periodLength" : 6,
"id" : "id",
"localDate" : "2000-01-23",
"time" : "time",
"tournamentCalendar" : {
"endDate" : "2000-01-23",
"name" : "name",
"id" : "id",
"startDate" : "2000-01-23"
},
"sport" : {
"name" : "name",
"id" : "id"
}
},
"liveData" : {
"matchDetails" : {
"periodId" : 1,
"matchLengthMin" : 7,
"matchStatus" : "matchStatus",
"period" : [ {
"announcedInjuryTime" : 1,
"lengthSec" : 7,
"lengthMin" : 6,
"start" : "2000-01-23T04:56:07.000+00:00",
"end" : "2000-01-23T04:56:07.000+00:00",
"id" : 1
}, {
"announcedInjuryTime" : 1,
"lengthSec" : 7,
"lengthMin" : 6,
"start" : "2000-01-23T04:56:07.000+00:00",
"end" : "2000-01-23T04:56:07.000+00:00",
"id" : 1
} ],
"matchLengthSec" : 1,
"winner" : "winner",
"scores" : {
"total" : {
"away" : 6,
"home" : 8
},
"ht" : {
"away" : 9,
"home" : 9
},
"ft" : {
"away" : 4,
"home" : 5
}
}
},
"event" : [ {
"eventId" : 0,
"periodId" : 5,
"contestantId" : "contestantId",
"playerName" : "playerName",
"timeSec" : 9,
"timeMin" : 7,
"timeStamp" : "2000-01-23T04:56:07.000+00:00",
"qualifier" : [ {
"qualifierId" : 2,
"id" : 5,
"value" : "value"
}, {
"qualifierId" : 2,
"id" : 5,
"value" : "value"
} ],
"x" : 2.027123023002322,
"y" : 4.145608029883936,
"typeId" : 3,
"id" : 6,
"lastModified" : "2000-01-23T04:56:07.000+00:00",
"outcome" : 1,
"playerId" : "playerId"
}, {
"eventId" : 0,
"periodId" : 5,
"contestantId" : "contestantId",
"playerName" : "playerName",
"timeSec" : 9,
"timeMin" : 7,
"timeStamp" : "2000-01-23T04:56:07.000+00:00",
"qualifier" : [ {
"qualifierId" : 2,
"id" : 5,
"value" : "value"
}, {
"qualifierId" : 2,
"id" : 5,
"value" : "value"
} ],
"x" : 2.027123023002322,
"y" : 4.145608029883936,
"typeId" : 3,
"id" : 6,
"lastModified" : "2000-01-23T04:56:07.000+00:00",
"outcome" : 1,
"playerId" : "playerId"
} ]
}
}
Produces
This API call produces the following media types according to the
request header; the media type will be
conveyed by the response header.
Responses
200
Match event details
inline_response_200_2
Get Match Preview (matchPreviewGet)
Fetches prematch data including head-to-head form, details of their last
five matches (form) and details of the event
Query parameters
event (required)
Query Parameter — The event ID
Return type
Example data
Content-Type: application/json
{
"previousMeetings" : {
"awayContestantGoals" : 5,
"match" : [ {
"date" : "date",
"country" : "country",
"goal" : [ {
"periodId" : "periodId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"contestantId\"" : "contestantId\"",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
}, {
"periodId" : "periodId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"contestantId\"" : "contestantId\"",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
} ],
"competitionCode" : "competitionCode",
"id" : "id",
"contestants" : {
"homeContestantShortName" : "homeContestantShortName",
"awayContestantCode" : "awayContestantCode",
"homeContestantCode" : "homeContestantCode",
"homeContestantId" : "homeContestantId",
"homeScore" : "homeScore",
"awayScore" : "awayScore",
"awayContestantShortName" : "awayContestantShortName",
"awayContestantOfficialName" : "awayContestantOfficialName",
"homeContestantOfficialName" : "homeContestantOfficialName",
"awayContestantName" : "awayContestantName",
"awayContestantId" : "awayContestantId",
"homeContestantName" : "homeContestantName"
},
"countryId" : "countryId"
}, {
"date" : "date",
"country" : "country",
"goal" : [ {
"periodId" : "periodId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"contestantId\"" : "contestantId\"",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
}, {
"periodId" : "periodId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"contestantId\"" : "contestantId\"",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
} ],
"competitionCode" : "competitionCode",
"id" : "id",
"contestants" : {
"homeContestantShortName" : "homeContestantShortName",
"awayContestantCode" : "awayContestantCode",
"homeContestantCode" : "homeContestantCode",
"homeContestantId" : "homeContestantId",
"homeScore" : "homeScore",
"awayScore" : "awayScore",
"awayContestantShortName" : "awayContestantShortName",
"awayContestantOfficialName" : "awayContestantOfficialName",
"homeContestantOfficialName" : "homeContestantOfficialName",
"awayContestantName" : "awayContestantName",
"awayContestantId" : "awayContestantId",
"homeContestantName" : "homeContestantName"
},
"countryId" : "countryId"
} ],
"draws" : 7,
"homeContestantGoals" : 9,
"awayContestantWins" : 2,
"homeContestantWins" : 3
},
"previousMeetingsAnyComp" : {
"awayContestantGoals" : 2,
"match" : [ {
"date" : "date",
"country" : "England",
"competitionId" : "competitionId",
"goal" : [ {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
}, {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
} ],
"competitionCode" : "competitionCode",
"competitionName" : "competitionName",
"id" : "id",
"tournamentCalendarName" : "tournamentCalendarName",
"contestants" : [ {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 1,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
}, {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 1,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
} ],
"countryId" : "string",
"tournamentCalendarId" : "tournamentCalendarId"
}, {
"date" : "date",
"country" : "England",
"competitionId" : "competitionId",
"goal" : [ {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
}, {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
} ],
"competitionCode" : "competitionCode",
"competitionName" : "competitionName",
"id" : "id",
"tournamentCalendarName" : "tournamentCalendarName",
"contestants" : [ {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 1,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
}, {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 1,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
} ],
"countryId" : "string",
"tournamentCalendarId" : "tournamentCalendarId"
} ],
"draws" : 7,
"homeContestantGoals" : 1,
"awayContestantWins" : 4,
"homeContestantWins" : 1
},
"formAnyComp" : [ {
"contestantId" : "contestantId",
"match" : [ {
"date" : "date",
"competitionId" : "competitionId",
"goal" : [ {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
}, {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
} ],
"competitionCode" : "competitionCode",
"competitionName" : "competitionName",
"id" : "id",
"tournamentCalendarName" : "tournamentCalendarName",
"contestants" : [ {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 0,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
}, {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 0,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
} ],
"tournamentCalendarId" : "tournamentCalendarId"
}, {
"date" : "date",
"competitionId" : "competitionId",
"goal" : [ {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
}, {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
} ],
"competitionCode" : "competitionCode",
"competitionName" : "competitionName",
"id" : "id",
"tournamentCalendarName" : "tournamentCalendarName",
"contestants" : [ {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 0,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
}, {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 0,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
} ],
"tournamentCalendarId" : "tournamentCalendarId"
} ],
"lastSix" : "lastSix"
}, {
"contestantId" : "contestantId",
"match" : [ {
"date" : "date",
"competitionId" : "competitionId",
"goal" : [ {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
}, {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
} ],
"competitionCode" : "competitionCode",
"competitionName" : "competitionName",
"id" : "id",
"tournamentCalendarName" : "tournamentCalendarName",
"contestants" : [ {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 0,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
}, {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 0,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
} ],
"tournamentCalendarId" : "tournamentCalendarId"
}, {
"date" : "date",
"competitionId" : "competitionId",
"goal" : [ {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
}, {
"periodId" : "periodId",
"contestantId" : "contestantId",
"assistPlayerLastName" : "assistPlayerLastName",
"assistPlayerShortLastName" : "assistPlayerShortLastName",
"scorerName" : "scorerName",
"assistPlayerFirstName" : "assistPlayerFirstName",
"assistPlayerName" : "assistPlayerName",
"scorerId" : "scorerId",
"timeMin" : "timeMin",
"type" : "type",
"assistPlayerShortFirstName" : "assistPlayerShortFirstName",
"scorerFirstName" : "scorerFirstName",
"assistPlayerId" : "assistPlayerId",
"scorerLastName" : "scorerLastName",
"scorerShortFirstName" : "scorerShortFirstName",
"scorerShortLastName" : "scorerShortLastName"
} ],
"competitionCode" : "competitionCode",
"competitionName" : "competitionName",
"id" : "id",
"tournamentCalendarName" : "tournamentCalendarName",
"contestants" : [ {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 0,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
}, {
"homeContestantShortName" : "Tottenham",
"awayContestantCode" : "MCI",
"homeContestantCode" : "TOT",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"homeScore" : 6,
"awayScore" : 0,
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantName" : "Tottenham Hotspur"
} ],
"tournamentCalendarId" : "tournamentCalendarId"
} ],
"lastSix" : "lastSix"
} ],
"form" : [ {
"contestantId" : "contestantId",
"match" : [ { }, { } ],
"lastSix" : "lastSix"
}, {
"contestantId" : "contestantId",
"match" : [ { }, { } ],
"lastSix" : "lastSix"
} ],
"matchInfo" : {
"date" : "2000-01-23",
"venue" : {
"neutral" : "neutral",
"id" : "id",
"shortName" : "shortName",
"longName" : "longName"
},
"week" : "week",
"var" : "var",
"coverageLevel" : "coverageLevel",
"ruleset" : {
"name" : "name",
"id" : "id"
},
"description" : "description",
"competition" : {
"country" : {
"name" : "name",
"id" : "id"
},
"competitionCode" : "competitionCode",
"name" : "name",
"competitionFormat" : "competitionFormat",
"id" : "id",
"knownName" : "knownName"
},
"numberOfPeriods" : 1,
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"localTime" : "localTime",
"stage" : {
"formatId" : "formatId",
"endDate" : "2000-01-23",
"name" : "name",
"id" : "id",
"startDate" : "2000-01-23"
},
"contestant" : [ {
"country" : {
"name" : "name",
"id" : "id"
},
"code" : "code",
"name" : "name",
"id" : "id",
"position" : "position",
"officialName" : "officialName",
"shortName" : "shortName"
}, {
"country" : {
"name" : "name",
"id" : "id"
},
"code" : "code",
"name" : "name",
"id" : "id",
"position" : "position",
"officialName" : "officialName",
"shortName" : "shortName"
} ],
"periodLength" : 5,
"id" : "id",
"localDate" : "2000-01-23",
"time" : "time",
"tournamentCalendar" : {
"endDate" : "2000-01-23",
"name" : "name",
"id" : "id",
"startDate" : "2000-01-23"
},
"sport" : {
"name" : "name",
"id" : "id"
}
}
}
Produces
This API call produces the following media types according to the
request header; the media type will be
conveyed by the response header.
Responses
200
Match preview details
inline_response_200_4
Get Match Stats (matchStatsGet)
Fetches statistics of a match fully inclusive of a statistical breakdown
on both a player & team basis
Query parameters
event (required)
Query Parameter — The event ID
Return type
Example data
Content-Type: application/json
{
"matchInfo" : {
"date" : "2000-01-23",
"venue" : {
"id" : "id",
"shortName" : "shortName",
"longName" : "longName"
},
"week" : "week",
"coverageLevel" : "coverageLevel",
"contestant" : [ {
"country" : {
"name" : "name",
"id" : "id"
},
"code" : "code",
"name" : "name",
"id" : "id",
"position" : "position",
"officialName" : "officialName",
"shortName" : "shortName"
}, {
"country" : {
"name" : "name",
"id" : "id"
},
"code" : "code",
"name" : "name",
"id" : "id",
"position" : "position",
"officialName" : "officialName",
"shortName" : "shortName"
} ],
"description" : "description",
"competition" : {
"country" : {
"name" : "name",
"id" : "id"
},
"competitionCode" : "competitionCode",
"name" : "name",
"competitionFormat" : "competitionFormat",
"id" : "id",
"knownName" : "knownName"
}
},
"matchDetails" : {
"matchLengthMin" : 3,
"matchStatus" : "matchStatus",
"period" : [ {
"announcedInjuryTime" : 4,
"lengthSec" : 1,
"lengthMin" : 1,
"start" : "2000-01-23T04:56:07.000+00:00",
"end" : "2000-01-23T04:56:07.000+00:00",
"id" : 7
}, {
"announcedInjuryTime" : 4,
"lengthSec" : 1,
"lengthMin" : 1,
"start" : "2000-01-23T04:56:07.000+00:00",
"end" : "2000-01-23T04:56:07.000+00:00",
"id" : 7
} ],
"matchLengthSec" : 2,
"winner" : "winner",
"scores" : {
"total" : {
"away" : 4,
"home" : 5
},
"ht" : {
"away" : 7,
"home" : 1
},
"ft" : {
"away" : 1,
"home" : 6
}
}
},
"liveData" : {
"stat" : [ {
"type" : "type",
"value" : "value"
}, {
"type" : "type",
"value" : "value"
} ],
"goal" : [ {
"periodId" : 7,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"homeScore" : 2,
"scorerName" : "scorerName",
"assistPlayerName" : "assistPlayerName",
"optaEventId" : "optaEventId",
"scorerId" : "scorerId",
"timeMin" : 9,
"type" : "type",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"awayScore" : 5,
"assistPlayerId" : "assistPlayerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
}, {
"periodId" : 7,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"homeScore" : 2,
"scorerName" : "scorerName",
"assistPlayerName" : "assistPlayerName",
"optaEventId" : "optaEventId",
"scorerId" : "scorerId",
"timeMin" : 9,
"type" : "type",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"awayScore" : 5,
"assistPlayerId" : "assistPlayerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
} ],
"teamOfficial" : [ {
"firstName" : "firstName",
"lastName" : "lastName",
"type" : "type"
}, {
"firstName" : "firstName",
"lastName" : "lastName",
"type" : "type"
} ],
"VAR" : [ {
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 0,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"decision" : "decision",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 6,
"type" : "type",
"outcome" : "outcome",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
}, {
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 0,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"decision" : "decision",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 6,
"type" : "type",
"outcome" : "outcome",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
} ],
"lineUp" : [ {
"contestantId" : "contestantId",
"formationUsed" : "formationUsed",
"kit" : {
"id" : "id",
"type" : "type",
"colour1" : "colour1",
"colour2" : "colour2"
},
"player" : [ {
"firstName" : "firstName",
"lastName" : "lastName",
"stat" : [ {
"type" : "type",
"value" : "value"
}, {
"type" : "type",
"value" : "value"
} ],
"position" : "position",
"playerId" : "playerId"
}, {
"firstName" : "firstName",
"lastName" : "lastName",
"stat" : [ {
"type" : "type",
"value" : "value"
}, {
"type" : "type",
"value" : "value"
} ],
"position" : "position",
"playerId" : "playerId"
} ]
}, {
"contestantId" : "contestantId",
"formationUsed" : "formationUsed",
"kit" : {
"id" : "id",
"type" : "type",
"colour1" : "colour1",
"colour2" : "colour2"
},
"player" : [ {
"firstName" : "firstName",
"lastName" : "lastName",
"stat" : [ {
"type" : "type",
"value" : "value"
}, {
"type" : "type",
"value" : "value"
} ],
"position" : "position",
"playerId" : "playerId"
}, {
"firstName" : "firstName",
"lastName" : "lastName",
"stat" : [ {
"type" : "type",
"value" : "value"
}, {
"type" : "type",
"value" : "value"
} ],
"position" : "position",
"playerId" : "playerId"
} ]
} ],
"card" : [ {
"cardReason" : "cardReason",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 1,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 5,
"type" : "type",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
}, {
"cardReason" : "cardReason",
"lastUpdated" : "2000-01-23T04:56:07.000+00:00",
"periodId" : 1,
"timeMinSec" : "timeMinSec",
"contestantId" : "contestantId",
"playerName" : "playerName",
"optaEventId" : "optaEventId",
"timeMin" : 5,
"type" : "type",
"playerId" : "playerId",
"timestamp" : "2000-01-23T04:56:07.000+00:00"
} ]
}
}
Produces
This API call produces the following media types according to the
request header; the media type will be
conveyed by the response header.
Responses
200
Match statistics details
inline_response_200_5
Get Matches by League (matchesByLeagueGet)
returns a full list of matches for the current season, grouped by event
date. Takes a single arg league which is the id for the league which can
be found by querying the /tournamentCalendar endpoint and
using the associated key.
Query parameters
league (required)
Query Parameter — The league ID
Return type
Example data
Content-Type: application/json
{
"date" : "2024-05-14T00:00:00Z",
"numberOfGames" : 1,
"match" : [ {
"date" : "2024-05-14T00:00:00Z",
"homeContestantCode" : "TOT",
"coverageLevel" : "15",
"numberOfPeriods" : 2,
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantShortName" : "Tottenham",
"localTime" : "20:00:00",
"awayContestantCode" : "MCI",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"periodLength" : 45,
"id" : "egv0s9zqavndyxn8dc3xi06c4",
"localDate" : "2024-05-14",
"time" : "19:00:00Z",
"optaBetting" : "1",
"homeContestantName" : "Tottenham Hotspur"
}, {
"date" : "2024-05-14T00:00:00Z",
"homeContestantCode" : "TOT",
"coverageLevel" : "15",
"numberOfPeriods" : 2,
"awayContestantName" : "Manchester City",
"awayContestantId" : "a3nyxabgsqlnqfkeg41m6tnpp",
"homeContestantShortName" : "Tottenham",
"localTime" : "20:00:00",
"awayContestantCode" : "MCI",
"homeContestantId" : "22doj4sgsocqpxw45h607udje",
"awayContestantShortName" : "Man City",
"awayContestantOfficialName" : "Manchester City FC",
"homeContestantOfficialName" : "Tottenham Hotspur FC",
"periodLength" : 45,
"id" : "egv0s9zqavndyxn8dc3xi06c4",
"localDate" : "2024-05-14",
"time" : "19:00:00Z",
"optaBetting" : "1",
"homeContestantName" : "Tottenham Hotspur"
} ]
}
Produces
This API call produces the following media types according to the
request header; the media type will be
conveyed by the response header.
Responses
200
Matches for the league
inline_response_200_1
Retrieve squad details (squadsGet)
Fetch detailed information about a specific squad, including players,
team kits, and tournament calendar.
Query parameters
teamId (required)
Query Parameter — The unique
identifier for the team.
leagueId (required)
Query Parameter — The unique
identifier for the league.
Return type
Example data
Content-Type: application/json
{
"lastUpdated" : "2024-11-19T15:09:21Z",
"squad" : [ {
"contestantShortName" : "Juventus",
"competitionId" : "1r097lpxe0xn03ihb7wi98kao",
"contestantId" : "bqbbqm98ud8obe45ds9ohgyrd",
"tournamentCalendarEndDate" : "2000-01-23",
"competitionName" : "Serie A",
"contestantClubName" : "Juventus",
"tournamentCalendarId" : "b25u56idqlgo8s1rahhltqd5g",
"venueName" : "Allianz Stadium",
"tournamentCalendarStartDate" : "2000-01-23",
"person" : [ {
"lastName" : "Hugeux",
"gender" : "Male",
"shirtNumber" : 18,
"matchName" : "A. Hugeux",
"active" : "yes",
"weight" : 73,
"dateOfBirth" : "2000-01-23",
"type" : "player",
"firstName" : "Alexandre",
"nationality" : "France",
"countryOfBirth" : "France",
"id" : "12xy19k97itjp3a958sm4n21g",
"position" : "Midfielder",
"foot" : "right",
"height" : 171
}, {
"lastName" : "Hugeux",
"gender" : "Male",
"shirtNumber" : 18,
"matchName" : "A. Hugeux",
"active" : "yes",
"weight" : 73,
"dateOfBirth" : "2000-01-23",
"type" : "player",
"firstName" : "Alexandre",
"nationality" : "France",
"countryOfBirth" : "France",
"id" : "12xy19k97itjp3a958sm4n21g",
"position" : "Midfielder",
"foot" : "right",
"height" : 171
} ],
"venueId" : "33cq9kqs9v4cbhl65j7wgnrsf",
"teamType" : "club",
"contestantName" : "Juventus FC",
"teamKits" : {
"kit" : [ {
"socksColour1" : "#f2f2ed",
"shirtColour1" : "#e8e473",
"shirtColour2" : "#f2f2ed",
"type" : "Away",
"shortsColour1" : "#f2f2ed"
}, {
"socksColour1" : "#f2f2ed",
"shirtColour1" : "#e8e473",
"shirtColour2" : "#f2f2ed",
"type" : "Away",
"shortsColour1" : "#f2f2ed"
} ]
},
"contestantCode" : "JUV"
}, {
"contestantShortName" : "Juventus",
"competitionId" : "1r097lpxe0xn03ihb7wi98kao",
"contestantId" : "bqbbqm98ud8obe45ds9ohgyrd",
"tournamentCalendarEndDate" : "2000-01-23",
"competitionName" : "Serie A",
"contestantClubName" : "Juventus",
"tournamentCalendarId" : "b25u56idqlgo8s1rahhltqd5g",
"venueName" : "Allianz Stadium",
"tournamentCalendarStartDate" : "2000-01-23",
"person" : [ {
"lastName" : "Hugeux",
"gender" : "Male",
"shirtNumber" : 18,
"matchName" : "A. Hugeux",
"active" : "yes",
"weight" : 73,
"dateOfBirth" : "2000-01-23",
"type" : "player",
"firstName" : "Alexandre",
"nationality" : "France",
"countryOfBirth" : "France",
"id" : "12xy19k97itjp3a958sm4n21g",
"position" : "Midfielder",
"foot" : "right",
"height" : 171
}, {
"lastName" : "Hugeux",
"gender" : "Male",
"shirtNumber" : 18,
"matchName" : "A. Hugeux",
"active" : "yes",
"weight" : 73,
"dateOfBirth" : "2000-01-23",
"type" : "player",
"firstName" : "Alexandre",
"nationality" : "France",
"countryOfBirth" : "France",
"id" : "12xy19k97itjp3a958sm4n21g",
"position" : "Midfielder",
"foot" : "right",
"height" : 171
} ],
"venueId" : "33cq9kqs9v4cbhl65j7wgnrsf",
"teamType" : "club",
"contestantName" : "Juventus FC",
"teamKits" : {
"kit" : [ {
"socksColour1" : "#f2f2ed",
"shirtColour1" : "#e8e473",
"shirtColour2" : "#f2f2ed",
"type" : "Away",
"shortsColour1" : "#f2f2ed"
}, {
"socksColour1" : "#f2f2ed",
"shirtColour1" : "#e8e473",
"shirtColour2" : "#f2f2ed",
"type" : "Away",
"shortsColour1" : "#f2f2ed"
} ]
},
"contestantCode" : "JUV"
} ]
}
Produces
This API call produces the following media types according to the
request header; the media type will be
conveyed by the response header.
Responses
200
Successful response with squad details.
inline_response_200_7
400
Bad Request. Missing or invalid team ID.
500
Internal Server Error.
Up
get /tournamentCalendar/
Get Tournament Calendar (tournamentCalendarGet)
Retrieves the active and authorized tournament calendar from which you
can get associated event IDs for use with other endpoints.
Return type
Example data
Content-Type: application/json
{
"country" : "England",
"competitionCode" : "EPL",
"opId" : "8",
"displayOrder" : 10,
"competitionType" : "club",
"type" : "men",
"countryId" : "1fk5l4hkqk12i7zske6mcqju6",
"isFriendly" : "no",
"countryCode" : "ENG",
"name" : "Premier League",
"competitionFormat" : "Domestic league",
"id" : "2kwbbcootiqqgmrzs6o5inle5",
"ocId" : "8",
"tournamentCalendar" : [ {
"lastUpdated" : "2024-04-29T01:43:28Z",
"includesStandings" : "yes",
"endDate" : "2024-05-19T00:00:00Z",
"name" : "2023/2024",
"includesVenues" : "yes",
"active" : "yes",
"id" : "1jt5mxgn4q5r6mknmlqv5qjh0",
"ocId" : "23514",
"startDate" : "2023-08-11T00:00:00Z"
}, {
"lastUpdated" : "2024-04-29T01:43:28Z",
"includesStandings" : "yes",
"endDate" : "2024-05-19T00:00:00Z",
"name" : "2023/2024",
"includesVenues" : "yes",
"active" : "yes",
"id" : "1jt5mxgn4q5r6mknmlqv5qjh0",
"ocId" : "23514",
"startDate" : "2023-08-11T00:00:00Z"
} ],
"knownName" : "English Premier League"
}
Produces
This API call produces the following media types according to the
request header; the media type will be
conveyed by the response header.
Responses
200
A list of tournaments
inline_response_200
[ Jump to Methods ]
Table of Contents
-
inline_response_200
-
inline_response_200_1
-
inline_response_200_2
-
inline_response_200_3
-
inline_response_200_4
-
inline_response_200_5
-
inline_response_200_6
-
inline_response_200_7
-
inline_response_200_8
id (optional)
example: 2kwbbcootiqqgmrzs6o5inle5
ocId (optional)
example: 8
opId (optional)
example: 8
name (optional)
example: Premier League
knownName (optional)
example: English Premier League
competitionCode (optional)
example: EPL
displayOrder (optional)
example: 10
country (optional)
example: England
countryId (optional)
example: 1fk5l4hkqk12i7zske6mcqju6
countryCode (optional)
example: ENG
isFriendly (optional)
example: no
competitionFormat (optional)
example: Domestic league
type (optional)
example: men
tournamentCalendar (optional)
competitionType (optional)
example: club
date (optional)
example: 2024-05-14T00:00Z
match (optional)
numberOfGames (optional)
example: 1
liveData (optional)
matchInfo (optional)
form (optional)
formAnyComp (optional)
matchInfo (optional)
previousMeetings (optional)
previousMeetingsAnyComp (optional)
liveData (optional)
matchDetails (optional)
matchInfo (optional)
matchInfo (optional)
messages (optional)
lastUpdated (optional)
example: 2024-11-19T15:09:21Z
squad (optional)
liveData (optional)
matchInfo (optional)