Introduction
The Field Hockey API offers schedules and results for the top leagues, and the data is collected by Sportradar's operators. The API updates live for select competitions and has a consistent structure, format, and behavior with other General Sport APIs. The primary feeds will provide information on tournaments, schedules, and results.
Moreover, additional feeds are available to provide complementary statistics, including
- Standings
- Historical results
- Match win probabilities
- Head-to-head statistics
API key authentication is required for all API calls.
API Map
To effectively use the Field Hockey API, you must have several parameters to create API calls. The map below shows how you can obtain these parameters.
For the primary feeds, you only need a date or human-readable parameters to call the endpoints. These feeds provide Sport Event Ids, Competitor Ids, or Season Ids, which you can use to generate the match, team, and tournament feeds.
Endpoint Descriptions
Competition Info - Provides the name, id, and parent id for a given competition.
Competition Seasons - Provides historical season information for a given competition. Competitions will return a maximum of three seasons of data, including current or newly created seasons.
Competitions - Provides a list of all available competitions.
Competitor Merge Mappings - Provides the valid Sportradar Id in cases when two competitors have been merged into one. Mapping entries will remain in the feed for 7 days.
Competitor Profile - Provides top-level information for a given team.
Competitor Summaries - Provides previous and upcoming game information for a given competitor, including results for past games and scheduling info for upcoming games.
Competitor vs Competitor - Provides previous and upcoming games between two teams, including scoring information.
Daily Summaries - Provides game schedules for a given day, including scoring information.
Live Summaries - Provides game information for all currently live games, including team scoring. This feed updates in real time as games are played.
Live Timelines - Provides a play-by-play event timeline for currently live games.
Live Timelines Delta – Provides a 10 second live delta of game information, including scoring and a play-by-play event timeline.
Season Competitors - Provides a list of teams participating for a given season.
Season Info - Provides detailed information for a given season, including participating teams and league structure.
Season Links - Provides information about linked cup rounds for a given season. Use this feed to compile full advancement brackets for relevant seasons/tournaments. Links between all matches and rounds are available when competitors (TBD vs. TBD) are not yet known.
Season Probabilities - Provides 3-way win probabilities (home team win, away team win, draw) for all games for a given season.
Season Standings - Provides detailed standings info for a given season.
Season Summaries - Provides schedule information and scoring for all matches from a given season.
Seasons - Provides a list of historical season information for all competitions. Competitions will return a maximum of three seasons of data, including current or newly created seasons.
Sport Event Summary - Provides real-time scoring for a given game. Please note that data returned is determined by coverage level.
Sport Event Timeline - Provides real-time scoring and a play-by-play event timeline for a given game. Please note that data returned is determined by coverage level.
Sport Events Created – Provides ids for sport events that have been created in the last 24 hours.
Sport Event Removed - Provides ids for sport events that have been removed or deleted.
Sport Event Updated - Provides ids for sport events that have been updated in the last 24 hours.
Data Retrieval Sample
To determine the probability of a home team winning a particular game, follow these steps:
- Call the Daily Schedule for the day the sport event will take place and locate the Season Id for the chosen sport event.
- Note the Sport Event Id for the given sport event.
- Call the Season Probabilities using the Season Id.
- Find the Sport Event Id within the results, locate the home team, and check the outcome probability.
The resulting probability will indicate the likelihood of the home team winning.
Integration Links
Postman Workspace
Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Field Hockey API collection.
Feel free to follow and/or fork any collections to receive updates.
Schema Download
Open the zip file below to access our entire Field Hockey API XSD schema.