The William Hill SportsData REST API is a collection of GET methods to provide William Hill product data such as sport, competition, event, market and selection data (including prices).
Every row below was read from the vendor's own OpenAPI document. The summary text is theirs. What this registry adds is that each operation is indexed with its method, path, base URL and auth scheme, so a search for a capability can answer with a call rather than a name, and that the endpoint is probed on a schedule.
Specifications as held by the APIs.guru corpus, whose newest record is 2023-04-21. Operations the vendor has added since are not listed here; the origin links above are the vendor's own current documents.
base URLs: https://sandbox.whapi.com/v2/sportsdata https://sandbox.whapi.com/v2/accounts https://sandbox.whapi.com/v2/bets https://sandbox.whapi.com/v2/locations https://sandbox.whapi.com/v2/sessions https://sandbox.whapi.com/v2/numbers
auth: a p i k e y
find it by capability: POST /search {"query":{"text":"..."}} returns these
operations with their invocation detail. Connect any agent client.
The William Hill SportsData REST API is a collection of GET methods to provide William Hill product data such as sport, competition, event, market and selection data (including prices).
| method | path | what the vendor says it does |
|---|---|---|
GET | /classes/{classId}/competitions/ | Retrieves a list of competitions for a given class id. Retrieves a list of competitions for a given class id. |
GET | /classes/{classId}/events/ | Retrieves a list of events for a given class id. Retrieves a list of events for a given class id. 'includeAllD |
GET | /competitions/{competitionId} | Retrieves a specific competition Retrieves a specific competition sportsdata |
GET | /competitions/{competitionId}/events/ | Retrieves a list of events for a given competition id. Retrieves a list of events for a given competition id. |
GET | /competitions/{competitionId}/marketgroups/ | Retrieves a list of market groups for a given competition id Retrieves a list of market groups for a given com |
GET | /competitions/{competitionId}/marketsByGroupid | Retrieves a list of events/markets/selections where markets within said event match selected sort/groupId Retr |
GET | /events/ | Retrieves a list of events for the provided IDs. Retrieves a list of events for the provided IDs. sportsdata |
GET | /events/{eventId} | Retrieves a single event by ID. Retrieves a single event by ID. sportsdata |
GET | /events/{eventId}/competitors | Retrieves competitors for a single event by ID. Retrieves competitors for a single event by ID. competitors |
GET | /events/{eventId}/markets/ | Gets one or more specific markets Retrieves one or more specific markets. Markets with Live at the end are alw |
GET | /events/{eventId}/markets/{marketId}/selections/ | Gets one or more selections for a market Retrieves one or more selections for a market sportsdata |
GET | /sports/ | Gets a list of all sports Gets a list of all sports sportsdata |
GET | /sports/{sportId}/classes/ | Retrieves a list of classes for a given sport id. Retrieves a list of classes for a given sport id. sportsdata |
GET | /sports/{sportId}/competitions/ | Retrieves a list of competitions for a given sport id. Retrieves a list of competitions for a given sport id. |
GET | /topbets/ | Retrieves a weighted list of Selections. Retrieves a weighted list of Selections. sportsdata |
specification origin: https://developer.williamhill.com/wh-docs/docs-sdks/sportsdata/swagger/docs
The Accounts API is a collection of methods used to query a customer account. It allows the developer to retrieve account-related data such as the user account balance. It should be noted that regional variations may exist - so some fields may not be returned for certain territories.
| method | path | what the vendor says it does |
|---|---|---|
GET | /account | Retrieves details of a customers account Retrieves a limited set of customer account details. For security pur |
GET | /account/balance | Get a customers account balance This method can be used to retrieve the customer’s account balance in UK Sterl |
POST | /account/flags | Sets a flag based on name to value provided for the user. Sets a flag based on name to value provided for the |
GET | /account/payments | Gets a customer's account payments Retrieves the customer’s account payments in UK Sterling. Accounts |
GET | /account/plusCard | Gets a customer's plus card details if they exist. Gets a customer's plus card details if they exist. Plus Car |
POST | /account/plusCard/lostStolen | Sets a customer's plus card as Lost/Stolen Sets a customer's plus card as Lost/Stolen Plus Card Omni Wallet Ca |
POST | /account/plusCard/phone/{oldPhoneNumber} | Sets a customer's plus card phone number Sets a customer's plus card phone number Plus Card Omni Wallet Card N |
POST | /account/plusCard/pin | Sets a customer's plus card pin Sets a customer's plus card pin Plus Card Omni Wallet Card Number |
PUT | /account/plusCard/pin | Updates a customer's plus card pin Updates a customer's plus card pin Plus Card Omni Wallet Card Number |
specification origin: https://developer.williamhill.com/wh-docs/docs-sdks/accounts/swagger/docs
The Bets API methods are used to place single, multiple and complex bets and to retrieve a customer’s bet history. When retrieving a customer’s bet history you can organize the bets from the betting history in terms of date, bet type and whether the bet is settled or not. You can also specify what fields to be included/excluded or return a list of all default fields the method returns. The Bets A
| method | path | what the vendor says it does |
|---|---|---|
POST | /bet/complex | Places a multiple or a complex bet. Places a multiple or a complex bet. Bets |
POST | /bet/single | Places a single bet Places a single bet. When placing a single bet using live inplay bets, the system might ge |
POST | /betslips | Organises the betslip when one or more selections are made. It returns a bet slip structure organised by betti |
GET | /freebets | Returns available free bets Retrieves the current free bets available for a customer. Bets |
GET | /history | Retrieves the customer’s bet history. Retrieves the customer’s bet history. Options are available to organise |
PUT | /{betId}/cashin | Allows a trusted application to cash in a bet (take a return on a bet) on behalf of the customer Allows a trus |
specification origin: https://developer.williamhill.com/wh-docs/docs-sdks/bets/swagger/docs
The Locations API is a collection of methods that support geographical information. The first method is an address lookup service for UK addresses. This service can be used to provide a new customer with a list of possible addresses from which they can populate a registration form.
| method | path | what the vendor says it does |
|---|---|---|
GET | /address/lookup/ | Retrieves a list of addresses when supplied with a house number or name and a postcode. It is generally used d |
GET | /countries/ | Retrieves a list of countries and its currencies. Locations |
GET | /countries/{countryCode} | Retrieves the specified country and its currency. Locations |
GET | /currencies/ | Retreives the list of currencies. Locations |
GET | /currencies/{currencyCode} | Retreives the specified currency. Locations |
specification origin: https://developer.williamhill.com/wh-docs/docs-sdks/locations/swagger/docs
The William Hill Sessions API uses a central authentication service (CAS*) on all resources that require access to a customer’s account or betting functionality. To authenticate, you’ll need to supply a sportsbook username and password, in return you will be given an authentication ticket, which you can use on the majority of requests found within our services. The Sessions API should be used whe
| method | path | what the vendor says it does |
|---|---|---|
POST | /tickets | Logs in a customer and obtains an authentication ticket. Logs in a customer by obtaining an authentication tic |
GET | /tickets/{tgt} | Checks the validity of a session ticket. Checks the validity of a session ticket. Sessions |
DELETE | /tickets/{tgt} | Log out a customer. Logs out a customer. Sessions |
GET | /tickets/{tgt}/serviceTicket | Obtains a one-time Service Ticket that can be used to access other William Hill services. Obtains a one-time S |
specification origin: https://developer.williamhill.com/wh-docs/docs-sdks/sessions/swagger/docs
The William Hill Numbers API uses a single method that allows you to generate random numbers for your application. Numbers can either be unique or can be produced with the chance that some might be the same. For example, you can have a highest value of 6 and a lowest value of 1 with a count of 2 with a unique value of false - this will give you two numbers between 1 and 6 which are independent, ju
| method | path | what the vendor says it does |
|---|---|---|
GET | /generate/integers | This method is used to generate random numbers for your app. Within the request, you can specify the lowest nu |
specification origin: https://developer.williamhill.com/wh-docs/docs-sdks/numbers/swagger/docs
nothing on this page is a rating, an endorsement or a claim about quality. Reachability is what our probes observed from one network; answering is a floor under usefulness, not a measure of it.