Get Event Results (API v3)

1. Send REST GET request

Request URL template: https://api-mst.oddsmarket.org/v1/eventResults?apiKey={apiKey}&sportIds={sportIds}&leagueId={leagueId}&startedFrom={startedFrom}&startedTo={startedTo}

Examples:

https://api-mst.oddsmarket.org/v1/eventResults?sportIds=1&leagueId=2&startedFrom=2016-05-01T12:00:00Z&startedTo=2016-05-02T12:00:00Z&apiKey=your_API_key_here

https://api-mst.oddsmarket.org/v1/eventResults?sportIds=21&apiKey=your_API_key_here

Check the request parameters specification below in this document.

2. In the response you will get a hierarchy of objects which contain arrays of requested events.

Example:

{
"sports": [
  {
    "id": 7,
    "name": "Soccer",
    "countries": [
      {
        "id": 11,
        "name": "Europe",
        "leagues": [
          {
            "id": 9428,
            "name": "Europe. UEFA Europa League",
            "nameRu": "Европа. Лига Европы УЕФА",
            "events": [
              {
                "ids": [138057818,142852241],
                "home": {
                  "id": 538,
                  "name": "Rapid Wien",
                  "nameRu": "Рапид Вена"
                },
               "away": {
                  "id": 8802,
                  "name": "Villarreal",
                  "nameRu": "Вильярреал"
                },
                "startedAt": "2018-11-08T18:55:00Z",
                "marketPrefix": "CNR",
                "score": "{\"0\":[5,5],\"1\":[1,4],\"2\":[4,1]}"
              }
            ]
          }
        ]
      }
    ]
  }
  ],
  "errors": {}
}

Check the response objects structure specification below in this document.

Request parameters specification

Parameter	Type	Required	Description
apiKey	VARCHAR	true	Your secret api key
sportIds	VARCHAR	false	Comma-separated list of sport IDs
leagueId	BIGINT	false	league ID
startedFrom	VARCHAR	false	Return matches that started after this timestamp. If this parameter is not specified, all results for the last 30 days are returned by default. Timetamp is expected in YYYY-MM-DDThh:mm:ssZ format in UTC timezone.
startedTo	VARCHAR	false	Return matches that started before this timestamp. Timetamp is expected in YYYY-MM-DDThh:mm:ssZ format in UTC timezone.

Response objects structure specification

Sport type

Field name	Type	Required	Description
id	SHORT	true	Id
name	VARCHAR	true	sport name
countries	Array of Countries	true	Countries container

Country type

Field name	Type	Required	Description
id	SHORT	true	Id
name	VARCHAR	true	Country name
leagues	Array of Leagues	true	leagues array

League type

Field name	Type	Required	Description
id	INT	true	Id
name	VARCHAR	true	league name
nameRu	VARCHAR	false	league name in Russian (if exists)
events	Array of Events	true	Events container

Event type

Field name	Type	Required	Description
ids	Array of BIGINT	true	array of event IDs
home	Team	true	Home Team
away	Team	true	Away Team
score	VARCHAR	true	match score
marketPrefix	VARCHAR	false	Score type identifier. If not specified (NULL or "") then it is a main score. Other variants: YC - yellow cards SUBS - substitution SHOT - shots on goal FOUL - foul POS - possession of the ball OFS - offside ACE - Ace DBF - Double fault
startedAt	VARCHAR	true	match start timestamp in YYYY-MM-DDThh:mm:ssZ format in UTC timezone

Team type

Field name	Type	Required	Description
id	BIGINT	true	Id
name	VARCHAR	true	Team Name
nameRu	VARCHAR	false	Team Name in Russian (of exists)