Football API Tech Docs

Question & Answers

Football API Match List: Results

Provides only the daily results in active season.

Football Match List: Results Request URL

GET

References / Dependencies

There is no references/dependencies for Match List. Match List endpoints works with only date parameter.

Call Rate / Interval

Recommended API Call Interval: 20 Request / Minute Daily Max API Call: 28800 Request

± 7 days Match Period

Match List data can be retrieved for only ± 7 days.

Request Headers

Data	Type	O / R	Example	Description
languageId	INT	R	{languageId}	The id of the language that you select.
Ocp-Apim-Subscription-Key	STR	R	{yourOcp-Apim-Subscription-Key}	Your account key.
Accept	STR	O	application/xml	Selection of data presentation type as XML/JSON.

^*O= Optional, R= Required

Request Parameters

Data	Type	O / R	Example	Description
date	DATE/STR	R	{dd/MM/yyyy}	Date of the match

Response Output

[ { "homeTeam": { "score": { "quarter1": 27, "quarter2": 26, "halfTime": 53, "quarter3": 23, "quarter4": 35, "regular": 111, "current": 111 }, "name": "Orlando Magic", "shortName": "ORL", "mediumName": "Magic", "id": 122 }, "awayTeam": { "score": { "quarter1": 30, "quarter2": 22, "halfTime": 52, "quarter3": 35, "quarter4": 19, "regular": 106, "current": 106 }, "name": "Philadelphia 76ers", "shortName": "PHI", "mediumName": "76ers", "id": 123 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "tournament": { "name": "NFL", "shortName": "NFL", "id": 9 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 16803 }, "round": { "name": "Round 5", "shortName": "W5", "id": 5 }, "date": "15/11/2018 00:00:00", "id": 287066 }, { "homeTeam": { "score": { "quarter1": 41, "quarter2": 32, "halfTime": 73, "quarter3": 23, "quarter4": 23, "regular": 119, "current": 119 }, "name": "Washington Wizards", "shortName": "WAS", "mediumName": "Wizards", "id": 130 }, "awayTeam": { "score": { "quarter1": 29, "quarter2": 23, "halfTime": 52, "quarter3": 22, "quarter4": 21, "regular": 95, "current": 95 }, "name": "Cleveland Cavaliers", "shortName": "CLE", "mediumName": "Cavaliers", "id": 105 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "tournament": { "name": "NFL", "shortName": "NFL", "id": 9 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 16803 }, "round": { "name": "Round 5", "shortName": "W5", "id": 5 }, "date": "15/11/2018 00:00:00", "id": 287067 } ]

sample - 1

Response Output Definitions

match

Data

Type

Example

Description

date

DATE/STR

03/02/2019 23:30:00

The starting date of the match, includes also time

INT

18656

The id of the match

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

New England Patriots

The full name of the home/away team

shortName

STR

The short name of the home/away team

mediumName

STR

Patriots

The medium name of the home/away team

INT

The id of the home/away team

score

Data	Type	Example	Description
current	INT	13	The current score of the match (live and post) for home/away team
quarter1	INT	0	The 1st quarter score of the match for home team
quarter2	INT	3	The 2nd quarter score of the match for home team
halfTime	INT	3	The half-time score of the match for home team
quarter3	INT	3	The 3rd quarter score of the match for home team
quarter4	INT	13	The 4th quarter score of the match for home team
regular	INT	13	The regular score of the match for home team
overTime	INT	0	The regular score of the match for home team

status

Data	Type	Example	Description
name	STR	Full Time	The name of the status
shortName	STR	FT	The short name of the status
id	INT	5	The id of the status

gameClock

Data	Type	Example	Description
minute	INT	5	Minute of the match
second	INT	18	Second of the match

tournament

Data	Type	Example	Description
name	STR	National Football League	The name of the tournament
shortName	STR	NFL	The short name of the tournament
id	INT	1	The id of the tournament

stage

Data	Type	Example	Description
name	STR	Super Bowl	The name of the stage
shortName	STR	SB	The short name of the stage
id	INT	726	The id of the stage

round

Data	Type	Example	Description
name	STR	Single Game	The name of the round
shortName	STR	SG	The short name of the round
id	INT	209	The id of the round

Football API Tech Docs

Tech Docs Index

Documentation

Widgets

Lookups

Global API

Soccer API

Basketball API

Football API

Baseball API

Ice Hockey API

Volleyball API

Handball API