Welcome to Ladbrokes API, a single stack of APIs that helps you build a Betting App using Ladbrokes functionality and data.
Our API (Application Programming Interface) enables you to integrate with us and build applications (referred to as apps henceforth) that leverage Ladbrokes functionality and data. Your app might be running in a Web browser, or on a server, smartphone, tablet, laptop, smart TV, games console, or numerous other platforms and devices that we haven’t even conceived of yet.
The Ladbrokes API is HTTP based, so it can be used from any application or device with an HTTP library. We follow a (mostly) RESTful model on our API, and we offer a choice of JSON or XML as data formats.
Here's our Getting Started guide that gives you more details.
Obtain an API Key
Register your organisation and application details with us and we will create an API Key for you. This key uniquely identifies your app and links it to the permissions and rate limits that will apply. It must be present in every request. We may (depending on the type of your app) also supply you with a ‘client secret’ (basically a password) that will be used to authenticate your app when you request an access token on behalf of a Ladbrokes customer.
In future we will offer a portal to support self-registration, however for the time-being please email email@example.com and ask for an API account registration form. Initially, your API Key will allow a limited throughput to support development and functional testing.
When you’re ready to put the app live, email us on the same address.
Test User Account
Register a user account with ladbrokes.com or if you have one already you can use that one.
Bet placements would normally be the last step of your app integration.
To test bet placements please do not use more than 10 pence.
Most selections that you bet on will have a minimum accepted value of 10 pence.
Authorisation Model (OAuth)
Ladbrokes’ API uses the OAuth 2.0 protocol so our customers can tell us whether or not to allow your app to do things like access their wallet balance and place bets using their Ladbrokes account. The result of a successful OAuth handshake is an ‘Access-Token’ which acts as a sort of restricted session token.
Ladbrokes supports 2 of the 4 main OAuth 2.0 grant types, namely ‘Authorisation Code’ and ‘Implicit’. This means that whether your application is server based, browser based, or device based (i.e. native applications), you should be able to use our API.
If you would like to determine which OAuth grant type your app should use or if you would like to understand our OAuth implementation in detail, Click Here.
The Ladbrokes API Console lets you explore the endpoints through an easy-to-use interface. It allows users to run API requests using their own data.
Test your requests and see the live responses from the services.
A Ladbrokes account is required to use few services.
You can explore Ladbrokes API in the API Console.
Notebooks are typical user journeys taken by customers.
The variation from an API Console is that you are stringing multiple API's and so you can go through a complete journey.
The below notebook takes you through one such user journey.
The App will establish a WebSocket connection to the Ladbrokes server directly from your browser and starts receiving updates related to in-play events/markets/selections.
You can also download API Push Java Client.
View our APIPush App which shows the in-play events and price changes instantaneously APIPush Notifications App.
Download our Scoreboard Visualisation App Scoreboard Visualisation App.
Betslip Toolkit abstracts a betslip creation by calling Ladbrokes API internally.
View the documentation for Betslip toolkit documentation.
View our Remote Betslip App which is build based on Betslip Toolkit.
Postman REST Client
This is a Google Chrome application that can run right in your browser or as a standalone-packaged application. Using this tool, you can easily make any kind of request to any endpoint you want. The tool provides many useful and powerful features that are very easy to use.
If you are just starting to understand what an API is or how it can be used, you can benefit from Postman to get familiar with Ladbrokes API.
We took the vast majority of Ladbrokes API calls and saved them as Postman 'Collections' to be shared with you!
To import the API collections, launch Postman and click ‘Import’
Upload the json files you can download from the following URL: Postman Collection
You should receive a successful message: “It worked!”
Once you import these and you’re ready to make some calls, you’ll need to add your own token into the Authorization Header.
The Authorization Header follows the format, Bearer [insert your token]
To receive a token you’ll need to create an app and get a client ID and client secret.
Showcase your work and get a production API Key.
As soon as you are ready please give us a test build, we would need to validate it for customer journeys and compliance requirements.
At this stage, your API quota will also be raised to Production level.
Please email to be assigned a production API Key.