Get Football Match Details API

Resolve an event ID into match identity, home and away teams, competition information, UTC kickoff and completion flags. Pass required eventid from match search or a fixture list. The verified event 5868072 returns status='success' and response.detail with matchId, matchName, matchRound, leagueId, leagueName, leagueRoundName, parentLeagueId, countryCode, homeTeam, awayTeam, matchTimeUTCDate, started and finished. teamColors and coverageLevel were also present. The observed derby was finished; coverageLevel='xG' is a coverage label, not an xG measurement. This detail response did not include the final score.

API Features

Resolved event identity matchId and matchName allow a fixture selection to be checked against its detail response.

Named opposing teams Observed homeTeam and awayTeam objects provide name and id for each participant.

Competition and round metadata leagueId, leagueName and round labels support a match header without name-only joins.

Kickoff and completion context matchTimeUTCDate, started and finished describe when the verified match took place and its completed state.

Live API Demo

GET /api/project/football/get-match-event-detail-by-event-id

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/football/get-match-event-detail-by-event-id?key=<API_KEY>&eventid=5868072'

curl -X GET 'https://api.opendata-api.com/api/project/football/get-match-event-detail-by-event-id?key=<API_KEY>&eventid=5868072'

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Create a match-centre header for the observed Madrid derby using its team, competition and kickoff fields.
Check a stored fixture's team IDs against the resolved detail record before publishing a report.
Route from a match page to both club profiles using homeTeam.id and awayTeam.id.
Retain coverage labels in an ingestion log without manufacturing missing xG values or final scores.

Frequently asked questions

Where do I obtain eventid for match details?

Select an actual event from match search or fixtures. The demonstrated public event example is 5868072; a team or league ID is not a substitute.

Does coverageLevel=xG provide an expected-goals value?

No. In the demonstrated detail response, xG was a coverage label, not a measurement. Validate the actual statistics response before displaying expected goals.

Do match details always include the final score?

No. The demonstrated completed match detail did not include it. Retain the verified fixture score or validate the dedicated score operation separately.

Related operations

Guides

View Subscription Plans →