API docs by Redocly

Affiliates API (1.0.0)

Download OpenAPI specification:

Terms of Service

The Affiliates API offers access to racing data for LADBROKES affiliates.

It provides both live updates and historical data, covering thoroughbred, harness, and greyhound races. The REST API is structured to supply affiliates with necessary data for platform development, including race conditions, results, betting odds, and analytics.

This API provides much of the information available on LADBROKES in a machine readable format. Each of the available endpoints have been described below. These endpoints are for personal use only and are not to be republished without written permission from Entain Australia and New Zealand.

Versioning

API versions are specified in the URL path, for example: /affiliates/v1/racing/meetings

The API adopts an open schema model, allowing the server to append additional properties to its responses. Similarly, the server will overlook any surplus query parameters and properties in the request body.

Client implementations should be designed to disregard unexpected properties in responses, maintaining compatibility with future server updates.

Endpoints flagged as Beta are under active development and are subject to change at any time.

Authentication

To avoid being blocked or inappropriately rate limited, please include Headers to identify who you are, and provide a way for us to contact you:

{
  From: joe@blogs.com.au
  X-Partner: Joe Blogs Pty Ltd
  X-Partner-ID: {Entain provided partner ID}
}

Events

Endpoints for retrieving racing events.

Specified Race

Retrieves a single specified race. Use optional parameters to enable additional betting information.

path Parameters
id
required
string

The ID of the race to retrieve.

query Parameters
bet_type_filter
string

Excludes the specified bet type from the response.

enc
string

Default: json

The response encoding format.

Available formats: (json | xml | html)

present_overlay
boolean

Default: false

with_big_bets
boolean

Default: false

Include any big bets that have been placed on the event.

with_biggest_bet
boolean

Default: false

Include the biggest bet placed on the event.

with_live_bets
boolean

Default: false

Include live bets that have been placed on the event.

with_money_tracker
boolean

Default: false

Include data to track the total amount wagered on event entrants.

with_tote_trends_data
boolean

Default: false

Include tote trends raw data in XML format.

with_will_pays
boolean

Default: false

Include any Will Pays that have been placed on the event.

Responses

Response samples

Content type
application/json
{
  • "big_bets": [
    ],
  • "biggest_bet": {
    },
  • "derivatives": [
    ],
  • "dividends": [
    ],
  • "error": "string",
  • "favourite": {
    },
  • "live_bets": [
    ],
  • "money_tracker": {
    },
  • "mover": {
    },
  • "race": {
    },
  • "results": [
    ],
  • "runners": [
    ],
  • "substitutions": [
    ],
  • "tote_pools": [
    ]
}

List of Races

Retrieves a list of races. Refine results using the optional filtering parameters.

query Parameters
countries
string

Filter races by one or more countries.

Available filters: (AUS | ARG | CA | CHI | DEU | FR | HK | IND | IRE | JPN | KOR | NOR | NZ | PER | SAF | SGP | SWE | UK | URY | USA)

date_from
string

Default: today

Include races from the specified date onwards.

Available filters: (YYYY-MM-DD | today | week | month | all)

date_to
string

Default: today

Include races up to and including the specified date.

Available filters: (YYYY-MM-DD | today | week | month | all)

enc
string

Default: json

The response encoding format.

Available formats: (json | xml | html)

limit
integer

Default: 100 Max: 200

Limit the number of items included in the response.

meet_types
string

Filter races by meet type: Thoroughbred, Harness, or Greyhound.

Available filters: (T | H | G)

order_by
integer

Default: 1

Set ascending/descending order by datetime.

Available filters: (0 | 1)

page_token
string

Page token, used for pagination.

Responses

Response samples

Content type
application/json
{
  • "next_page_token": "string",
  • "races": [
    ]
}

Meetings

Endpoints for retrieving racing meetings.

List of Meetings

Retrieves a list of meetings. Refine results using the optional filtering parameters. If filtering by meeting numbers or IDs, ensure that only one is provided, not both

query Parameters
category
string

Filter meetings by category: Thoroughbred, Harness, or Greyhound.

Available filters: (T | H | G)

country
string

Filter meetings by country.

Available filters: (AUS | ARG | CA | CHI | DEU | FR | HK | IND | IRE | JPN | KOR | NOR | NZ | PER | SAF | SGP | SWE | UK | URY | USA)

date_from
string

Default: today

Include meetings from the specified date onwards.

Available filters: (YYYY-MM-DD | today | week | month | all)

date_to
string

Default: today

Include meetings up to and including the specified date.

Available filters: (YYYY-MM-DD | today | week | month | all)

enc
string

Default: json

The response encoding format.

Available formats: (json | xml | html)

futures
boolean

Default: false

Include futures markets.

ids
string

Filter meetings by one or more comma-separated IDs.

limit
integer

Default: 100 Max: 200

Limit the number of items included in the response.

meeting_numbers
string

Filter meetings by one or more comma-separated meeting numbers. (Only available to selected partners)

offset
integer

Default: 0

Skip the first offset responses, used for pagination.

Responses

Response samples

Content type
application/json
{
  • "meetings": [
    ]
}

Specified Meeting

Retrieves a single specified meeting.

path Parameters
id
required
string

The ID of the meeting to retrieve.

query Parameters
enc
string

Default: json

The response encoding format.

Available formats: (json | xml | html)

Responses

Response samples

Content type
application/json
{
  • "meetings": [
    ]
}

Futures

Endpoints for retrieving futures markets.

List of Futures

List futures markets

query Parameters
enc
string

Default: json

The response encoding format.

Available formats: (json | xml | html)

Responses

Response samples

Content type
application/json
{
  • "meetings": [
    ]
}

Channels

Endpoints for retrieving racing events by channel.

List of Races by Channel

List races by broadcasting channel

query Parameters
channel
required
string

Filter races by broadcasting channel.

Available filters: (Trackside1 | Trackside2 | Live1 | Live2 | NoVideos)

date
string

Default: today

Filter races by date.

Available filters: (YYYY-MM-DD | today | week | month | all)

enc
string

Default: json

The response encoding format.

Available formats: (json | xml | html)

type
string

Filter races by meet type: Thoroughbred, Harness, or Greyhound.

Available filters: (T | H | G)

Responses

Response samples

Content type
application/json
{
  • "races": [
    ]
}

Extras

Endpoints for retrieving extras markets.

List of Meetings with Extras

Retrieves a list of meetings with extras markets available.

Refine results using the optional filtering parameters.

query Parameters
categories
string

Filter extras by categories: Thoroughbred, Harness, or Greyhound.

Available filters: (T | H | G)

countries
string

Filter extras by one or more countries.

Available filters: (AUS | ARG | CA | CHI | DEU | FR | HK | IND | IRE | JPN | KOR | NOR | NZ | PER | SAF | SGP | SWE | UK | URY | USA)

date_from
string

Default: today

Include extras from the specified date onwards.

Must be within a maximum of 2 days from date_to.

Available filters: (YYYY-MM-DD | today | week | month | all)

date_to
string

Default: today

Include extras up to and including the specified date.

Must be within a maximum of 2 days from date_from.

Available filters: (YYYY-MM-DD | today | week | month | all)

enc
string

Default: json

The response encoding format.

Available formats: (json | xml)

page_token
string

Page token, used for pagination.

Responses

Response samples

Content type
application/json
{
  • "extras": [
    ],
  • "next_page_token": "string"
}

Extras for a Specified Meeting

Retrieves detailed extras markets for a single specified meeting.

path Parameters
id
required
string

The ID of the meeting to retrieve extras for.

query Parameters
enc
string

Default: json

The response encoding format.

Available formats: (json | xml)

Responses

Response samples

Content type
application/json
{
  • "extras": {
    }
}