Retrieve upcoming racing competitions

To retrieve information about future competitions, including their names, event numbers, event codes, and runner information, you can make a GET request to the following endpoint:

Endpoint

GET /competition/namecodes/

CURL example

curl -X GET https://betmatic.app/api/competition/namecodes/ \
  -H 'Accept: application/json' \
  -H 'Authorization: Token {token}'
  

This will return a list of future competitions with details such as their names, event numbers, event codes, and information about the runners participating in each competition. You can use this information when creating notifications or publishing tips.

Responses

Status	Meaning	Description	Schema
200	OK	Success	See below

200 Response example

[
    {
        "code": "Galloping",
        "name": "UTTOXETER",
        "event_number": 1,
        "startTime": "2023-07-12T02:35:00+10:00",
        "runners": "1,2,3",
        "runner_names": "A DIFFERENT KIND#&#SILVER SHEEN#&#DONNIE AZOFF"
    },
    {
        "code": "Harness",
        "name": "CABOURG",
        "event_number": 1,
        "startTime": "2023-07-12T02:35:00+10:00",
        "runners": "1,2,3,4,5,6,7,8,9,10,11,12",
        "runner_names": "HIPPO DE POMMERAYE#&#HOBSON#&#HORTENSIA DE LARRE#&#HAMYOT DE BOMO#&#HADES DE L'ITON#&#HAMIGO#&#HALDO D'YMER#&#HAROLD SAUTONNE#&#HETRE D'OURVILLE#&#GELASQUEZ#&#HOLD UP DES VENTES#&#HELIOS SOMOLLI"
    },
]

Response Schema

Status Code 200

Name	Type	Description
code	string	This field represents the racing type and can have values like Galloping, Harness, or Greyhounds.
name	string	The name of the venue where the competition takes place.
event_number	integer	The event number, which corresponds to the race number.
runners	string	The number of the runner that has not been scratched. They are returned as a string with each runner's name separated by a comma.
startTime	string	The starting time of the event.
runner_names	string	The runners participating in the race. They are returned as a string with each runner's name separated by string '#&#'.