Get Match Detail
Returns the complete match payload including team & competition names, venue, referee, scores by period, and an embedded 3D animation widget URL.
GET /api/v1/match/{matchId}?tz=00:00
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.sportsapipro.com/v6/football/match/ezk96i3gzz5a1kn"
Response
{
"success": true,
"cacheHit": false,
"match": {
"id": "ezk96i3gzz5a1kn",
"sportId": 1,
"matchStatus": 3,
"matchTime": 1782612000,
"homeScores": [1, 0, 0, 3, 2, 0, 0],
"awayScores": [3, 2, 0, 0, 6, 0, 0],
"homeTeam": {
"id": "zjek33i08didko2",
"name": "Jordan",
"logo": "92a6308394834fd38eadaf9105c99749.png",
"sportId": 1,
"national": 1
},
"awayTeam": {
"id": "8vmqy9i232b4k9r",
"name": "Argentina",
"logo": "ef7329946e1741b9ade4fedbf739158a.png",
"national": 1
},
"competition": {
"id": "p0ndkz6izigq3z1",
"name": "FIFA World Cup",
"logo": "da617cd58cd9cffaae0daec865457fb5.png"
},
"venue": {
"name": "Dallas Stadium",
"capacity": 92967,
"city": "Dallas",
"country": "United States"
},
"referee": null
},
"incidents": [],
"stats": [],
"lineups": null,
"tables": [],
"animation": {
"url": "https://widgets.sportsapipro.com/3d/football?match=ezk96i3gzz5a1kn",
"ratio": 0.505
},
"stream": null,
"esportsStats": null
}
| Field | Type | Description |
|---|
match | object | Core match data |
match.homeTeam | object | Home team { id, name, logo, national } (national: 1 = national team) |
match.awayTeam | object | Away team |
match.competition | object | Competition { id, name, logo } |
match.venue | object | Stadium { name, city, capacity, country } |
match.matchTime | number | Unix epoch (seconds) |
match.matchStatus | number | 1 NS · 2 Live · 3 FT · 4 Postponed · 5 Cancelled |
match.homeScores / awayScores | array | [FT, 1H, 2H, ET1, ET2, Pens, …] |
incidents | array | See Match Incidents |
stats | array | See Match Stats |
lineups | object | null | See Match Stats |
animation | object | null | 3D animation widget { url, ratio } |
esportsStats | object | null | Esports-only payload |
The match-detail call is the single best way to hydrate a list returned by /today or /future. Use the returned match.id as the lookup key.
