Retrieve upcoming racing competitions

GET /competition/namecodes/

Retrieve future competition names along with event numbers, event codes, and runner details. This includes only upcoming games, which users can utilize when creating notifications or publishing tips.

Parameters

No parameters required.

Response

Success Response (200)

Returns upcoming racing competitions with detailed information:

[
  {
    "code": "string",
    "name": ["string"],
    "event_number": "integer",
    "starttime": "string(date-time)",
    "runners": "string",
    "runner_names": "string",
    "country": "string",
    "scrape_date": "string(date-time)"
  }
]

Response Fields

Field	Type	Description
code	string	Code of Galloping, Harness and Greyhounds
name	array[string]	Venue name
event_number	integer	Event number i.e., race no.
starttime	string	StartTime of the event
runners	string	Runners - a comma-separated list of numbers are returned as a string separated by comma
runner_names	string	Runner names - Name of the runners for the race are returned as a string separated by comma
country	string	Country
scrape_date	string	Scrape date

Example

curl -X GET "https://betmatic.app/api/competition/namecodes/" \
  -H "Authorization: Token your_token"

Error Responses

• 400 Bad request - Invalid request parameters

• 401 Invalid credentials - Authentication token is invalid or missing

Authentication

This endpoint requires authentication. Include your token in the Authorization header:

Authorization: Token your_token