Retrieve upcoming events

To retrieve information about upcoming events, including their names startTime, you can make a GET request to the following endpoint:

Endpoint

GET /event/list/?sports=[code] Here, code should be one of the following options: AFL, NBA, American Football, Baseball, Basketball, Boxing, Cricket, Darts, Handball, Ice Hockey, Rugby League, Rugby Union, Soccer, Tennis, or Volleyball.

CURL example

curl -X GET https://betmatic.app/api/event/list/?sports=AFL \
  -H 'Accept: application/json' \
  -H 'Authorization: Token {token}'

This will return a list of future events with details such as their names and their start time. You can use this information when creating notifications.

Responses

Status	Meaning	Description	Schema
200	OK	Success	See below

200 Response example

[
    {
        "sports": "AFL",
        "title": "SYDNEY V WESTERN BULLDOGS",
        "id": 13322,
        "startTime": "2023-07-13T19:20:00+10:00",
        "status": "ACTIVE",
        "participant1": "SYDNEY SWANS",
        "participant2": "WESTERN BULLDOGS"
    },
    {
        "sports": "AFL",
        "title": "MELBOURNE V BRISBANE",
        "id": 13333,
        "startTime": "2023-07-14T19:50:00+10:00",
        "status": "ACTIVE",
        "participant1": "MELBOURNE",
        "participant2": "BRISBANE LIONS"
    }
]

Response Schema

Status Code 200

Name	Type	Description
id	integer	Event id used in this system.
title	string	The name of the event
sports	string	Sports should be one of the following options: AFL, NBA, American Football, Baseball, Basketball, Boxing, Cricket, Darts, Handball, Ice Hockey, Rugby League, Rugby Union, Soccer, Tennis, or Volleyball.
startTime	string	Start Time of an event.
status	string	Status of an event.
participant1	string	Team Name
participant2	string	Team Name