Docs
Coverage MatrixDocumentationRelease LogLog In

Introduction

The Futsal API provides real-time scoring and statistics (when available) and an array of supplementary data.

All major competitions are covered. Select the Futsal package in our Coverage Matrix for competitions and data offered.

The API is consistent in structure, format, and behavior with the other General Sport APIs. Primary feeds will return seasons, competitions, team and player data, and real-time scores.

Additional feeds provide a host of complementary stats, including:

  • Competitor profiles
  • Standings
  • Historical results
  • Match win probabilities

🗝️

Authentication is required for all API calls.

API Map

To best utilize the Futsal v2 API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.

Primary feeds only require dates, human-readable parameters or a Competition Id (which can be found in the competitions endpoint), while other feeds require a global unique identifier (GUID) to identify the sport event or competitor that the feed will describe. The primary feeds provide GUIDs for sport events, competitions, and competitors, while sport event and competitors provide GUIDS for players.


Endpoint Descriptions

Competition Info - Provides the name, id, and gender 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 competitor.

Competitor Summaries - Provides previous and upcoming match information for a given competitor, including results for past matches and scheduling info for upcoming matches. 

Competitor vs. Competitor - Provides previous and upcoming games between two competitors, including scoring information. 

Daily Summaries - Provides match information for a given day, including scoring and results.

Live Summaries - Provides game information for all currently live matches, including scoring.

Live Timelines - Provides an event timeline for currently live matches. 

Live Timelines Delta - Provides a 10 second live delta of game information, including scoring and an event timeline. 

Season Competitors - Provides a list of competitors participating in a given season. 

Season Info - Provides detailed information for a given season, including participating competitors 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 match win probabilities (home team win, away team win, draw) for all matches in a given season.  

Season Standings - Provides detailed standings info for a given season.

Season Summaries - Provides schedule information for all matches from a given season including scoring at the match level. 

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 match-level scoring for a given match.

Sport Event Timeline - Provides a real-time event timeline of scoring for a given match. 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 Events Removed - Provides ids for sport events that have been removed or deleted.

Sport Events Updated - Provides ids for sport events that have been updated in the last 24 hours.


Data Retrieval Sample

To find the probability of a home team win for a given game:

  1. Call the Daily Summaries for the day the sport event takes place and find the Sport Event Id for the chosen sport event
  2. Make note of the Sport Event Id for the given sport event
  3. Call the Season Probabilities using the Season Id
  4. Find Sport Event Id within the results locate the home team and the outcome probability

The probability of a home team win is displayed.


Integration Links

OpenAPI Spec

Our Futsal API is available via OpenAPI. Click below to view and/or download the specs.

Futsal v2 OpenAPI

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Futsal 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 Futsal API XSD schema.

Futsal v2 Schema