Soccer API Tech Docs

Search in tech docs

Soccer API Match List: Results

Provides the daily results in active season.

Soccer 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

This 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": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "I.Santa Fe", "shortName": "ISF", "mediumName": "I. Santa Fe", "id": 9415 }, "awayTeam": { "score": { "regular": 2, "halfTime": 2, "current": 2 }, "name": "Deportes Tolima", "shortName": "DTO", "mediumName": "Dep. Tolima", "id": 8265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "tournament": { "name": "Colombia Primera - Clausura", "shortName": "KPC", "id": 366 }, "stage": { "name": "Quarter-Final", "shortName": "QF", "id": 37633 }, "round": { "name": "Game 1", "shortName": "M1", "id": 199 }, "date": "15/11/2018 01:00:00", "id": 1345660 }, { "homeTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "Independiente Med.", "shortName": "DIM", "mediumName": "Medellin", "id": 5631 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Bucaramanga", "shortName": "AB", "mediumName": "Bucaramanga", "id": 4791 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "tournament": { "name": "Colombia Primera - Clausura", "shortName": "KPC", "id": 366 }, "stage": { "name": "Quarter-Final", "shortName": "QF", "id": 37633 }, "round": { "name": "Game 1", "shortName": "M1", "id": 199 }, "date": "15/11/2018 01:00:00", "id": 1345658 } ]

Response Output Definitions

match

Data

Type

Example

Description

date

DATE/STR

14/11/2018 09:00:00

The kick-off date of the match, includes also time

INT

1344394

The id of the match

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

England (U19)

The full name of the home/away team

shortName

STR

ENG

The short name of the home/away team

mediumName

STR

England (U19)

The medium name of the home/away team

INT

251

The id of the home/away team

score

Data	Type	Example	Description
regular	INT	4	The regular score of the match for home/away team
halfTime	INT	1	The half-time score of the match for home/away team
current	INT	4	The current score of the match (live and post) for home/away team
penalties	INT	4	The penalty score of the match for home/away team
extraTime	INT	4	The extra time score of the match for home/away 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

tournament

Data	Type	Example	Description
name	STR	U19 European Championship - Qualification	The name of the tournament
shortName	STR	U19E	The short name of the tournament
id	INT	265	The id of the stage

stage

Data	Type	Example	Description
name	STR	5th Group	The name of the stage
shortName	STR	5	The short name of the stage
id	INT	38631	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 1	The name of the round
shortName	STR	W1	The short name of the round
id	INT	1	The id of the round

Soccer 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+

Table Tennis API+

Tennis API+