Football

Football middleware available for all clients and partners. REST API's for all feeds for teams / fixtures / results / live matches / line ups / tables / statistics / officials / commentary / player-traits / head to head / form / competitions

Base URL - stage: https://opta-football-stage.cortextech.io/

Base URL - prod: https://opta-football.cortextech.io/

API Reference: https://developer.cortextech.io/reference/get_v1-form-teamid

API Keys

All requests must be made using provided API keys, otherwise a 401 Unauthorized response will be returned, the API key comprises of 3 items that must be passed in the headers of each request:

X-API-KEY
X-APP-ID
X-REALM

Key Terms and Language used throughout the API

Term	Description
Season	The way competitions/tournaments/leagues are organised within the system. There is only ever 1 occurrence of a competition per season. For example, there will be a 2024 season, which will contain all the data relating to the English Premier League for that period only, there will also be a 2025 season for the EPL
Season ID	The unique identifier for a season.
Competition	A Tournament/Competition/League within football, e.g. English Premier League, Champions League or World Cup
Competition ID	The unique identifier for a competition. This will always be the same value for each year a competition is played, i.e. the English Premier League will always have the same competition ID, whether you are trying to retrieve data from 2020's season or from 2025's season.
Match	A single fixture between two teams
Match ID	The unique identifier for a match
Team	A single football team
Team ID	The unique identifier for a team
Player	A person who plays for a team.
Player ID	The unique identifier for a player. If a player moves between teams they will always retain the same player ID.

Standard API Responses

Standard response payloads:

{
  "status": "string",
  "data": [
    { "array of items" }
	],
  "metadata": {
    "createdAt": "ISO 8601 Date/Time format",
    "pageItems": 0,
    "totalItems": 0,
    "totalPages": 0,
    "pageNumber": 0,
    "pageSize": 0,
    "sort": "string"
  }
}

{
  "status": "string",
  "data": { "single item" },
  "metadata": {
    "createdAt": "ISO 8601 Date/Time format"
  }
}

{
  "status": "fail",
  "message": "reason",
  "metadata": {
    "createdAt": "ISO 8601 Date/Time format"
  }
}