Developer Portal

Global API Documentation

This is the documentation for our Global API. To get a more comprehensive understanding of what feeds we have to offer and the data points we deliver via our endpoints, we encourage you to explore the following resources:

Data Dictionary
Help Center

All of our API endpoints can be accessed via an HTTP GET request using your API key. The API key can be passed either as a query parameter or using the following HTTP request header.
Ocp-Apim-Subscription-Key: {key}

Sport & Competition Feeds

Sports & Competitions

Available Endpoints
Subfeed
GET Competitions
Sports & Competitions
Returns all competitions (such as leagues, tournaments, cups etc.) that exist within a given sport.
Competition
GET Phases
Sports & Competitions
Returns a list of phases (such as tournament rounds, matchdays, game days etc.) for a given competition's season.
Phase
GET Seasons
Sports & Competitions
Returns a list of seasons for a given competition.
Season
GET Sports
Sports & Competitions
Returns all sports available in the Global Sports API, each with a unique identifier.
Sport

Competitions

Returns all competitions (such as leagues, tournaments, cups etc.) that exist within a given sport.
Endpoint Notes
Return Type:
Competition[]
Included Data Tables:
Competition
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.

Phases

Returns a list of phases (such as tournament rounds, matchdays, game days etc.) for a given competition's season.
Endpoint Notes
Return Type:
Phase[]
Included Data Tables:
Phase
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.
competition
string
true
The slug of the competition.
seasonId
integer
true
The season ID for which phases are being returned.

Seasons

Returns a list of seasons for a given competition.
Endpoint Notes
Return Type:
Season[]
Included Data Tables:
Season
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.
competition
string
true
The slug of the competition.

Sports

Returns all sports available in the Global Sports API, each with a unique identifier.
Endpoint Notes
Return Type:
Sport[]
Included Data Tables:
Sport
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.

Teams, Players & Rosters

Available Endpoints
Subfeed
GET Athletes
Teams, Players & Rosters
Returns all athletes for a given competition within a sport.
Athlete
GET Teams
Teams, Players & Rosters
Returns all teams active in a given season within a given competition.
Team

Athletes

Returns all athletes for a given competition within a sport.
Endpoint Notes
Return Type:
Athlete[]
Included Data Tables:
Athlete
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.
competition
string
true
The slug of the competition.

Teams

Returns all teams active in a given season within a given competition.
Endpoint Notes
Return Type:
Team[]
Included Data Tables:
Team
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.
competition
string
true
The slug of the competition.
seasonId
integer
true
The season ID for which teams are being returned.

Venues & Officials

Available Endpoints
Subfeed
GET Venues
Venues & Officials
Returns all venues that are used within a given competition.
Venue

Venues

Returns all venues that are used within a given competition.
Endpoint Notes
Return Type:
Venue[]
Included Data Tables:
Venue
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.
competition
string
true
The slug of the competition.

Event Feeds

Event Schedules & Game Day Info

Available Endpoints
Subfeed
GET Event Schedule by Date
Event Schedules & Game Day Info
Returns a list of events for a given competition on a given date.
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat
GET Event Schedule by Phase
Event Schedules & Game Day Info
Returns a list of events for a given competition's given phase.
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat

Event Schedule by Date

Returns a list of events for a given competition on a given date.
Endpoint Notes
Return Type:
Event[]
Included Data Tables:
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat
Ideal For:
For finding upcoming games on a given date.
Not Ideal For:
Scores. Use a Scores endpoint for this purpose, either Live or final only.
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.
competition
string
true
The slug of the competition.
date
string
true
The date for which the event schedule is returned. All dates/times are in UTC.

Event Schedule by Phase

Returns a list of events for a given competition's given phase.
Endpoint Notes
Return Type:
Event[]
Included Data Tables:
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat
Ideal For:
For finding upcoming games for a given phase.
Not Ideal For:
Scores. Use a Scores endpoint for this purpose, either Live or final only.
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.
competition
string
true
The slug of the competition.
phaseId
string
true
The phase ID for which event schedule is returned.

Scores & Game State

Available Endpoints
Subfeed
GET Event Results by Date
Final Only (No Game State)
Returns post-game scores for a given competition's events on a given date.
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat
GET Event Results by Phase
Final Only (No Game State)
Returns post-game scores for a given phase within a single competition.
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat
GET Event Results Live by Date
Live & Final (With Game State)
Returns live scores for a given competition's events on a given date.
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat
GET Event Results Live by Phase
Live & Final (With Game State)
Returns live scores for a given competition's events for a given phase.
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat

Event Results by Date

Returns post-game scores for a given competition's events on a given date.
Endpoint Notes
Return Type:
Event[]
Included Data Tables:
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat
Ideal For:
Final scores after the event has concluded.
Not Ideal For:
Live scores. Use Event Results Live by Date for this.
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.
competition
string
true
The slug of the competition.
date
string
true
The date for which the event schedule is returned. All dates/times are in UTC.

Event Results by Phase

Returns post-game scores for a given phase within a single competition.
Endpoint Notes
Return Type:
Event[]
Included Data Tables:
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat
Ideal For:
Final scores.
Not Ideal For:
In-play scores. Use Event Results Live by Phase for this.
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.
competition
string
true
The slug of the competition.
phaseId
string
true
The phase ID for which event schedule is returned.

Event Results Live by Date

Returns live scores for a given competition's events on a given date.
Endpoint Notes
Return Type:
Event[]
Included Data Tables:
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat
Ideal For:
Live scores, not just post-game scores.
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.
competition
string
true
The slug of the competition.
date
string
true
The date for which the event schedule is returned. All dates/times are in UTC.

Event Results Live by Phase

Returns live scores for a given competition's events for a given phase.
Endpoint Notes
Return Type:
Event[]
Included Data Tables:
AmFootballEventState AmFootballParticipant AmFootballParticipantResults Event RoundInfo TennisEventFormat
Ideal For:
Live scores, not just post-game scores.
GET {{url=vm.FormatUrl(urlOp, true);""}}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
Key not yet enabled.
URL Template Parameters
Parameter Name
Type
Required
Value
sport
string
true
The slug of the sport.
competition
string
true
The slug of the competition.
phaseId
string
true
The phase ID for which event schedule is returned.
Copyright © 2026 SportsDataIOTM
Contact Us