We have put together a list of FAQs with the questions we get asked the most! How do I get my API key and secret? Once you have presented your development idea to us and it is approved, you will receive a welcoming email with useful information along with your API key and secret to the sandbox environment. More information:4 steps to your app going LiveEnvironments I'm not getting price feeds. What can I do to receive price feeds? If you're trying to access our price feed for the first time, this might be an implementation problem or if the solution worked before and stopped working now, we may be experiencing technical issues. Whatever the case, you need to create a support ticket about the problem you have and give us as much detail as possible on what exactly is happening on your end, so we can help you. For example, what error messages did you get, which methods are you using, and so on. How do I get a test account? You will need to create a support ticket for it , giving us the following details: The full name of the test account customer The email address The contact number for the person using the test account I have a test account. How do I fund it? You will need to create a support ticket for it , giving us the following details: The user name the test account The amount of money you want funded in it I need some free bets for testing purposes in the sandbox environment. How can I get them? To do that, you need to contact us by creating a support ticket for that. What if the service I am interested in is not available? If you cannot find an API or group of APIs that suit your development needs, contact your business manager at William Hill for more details about our specialist, bespoke and private APIs. What are the geographical restrictions for my published app or site outside of the UK? For an up-to-date list of all territories for which you can currently develop apps and websites that allow customers to register, deposit money and place bets on the the sportsbook, go to Available Geographical Locations When do I use the Sessions API? The William Hill Sessions API uses an authentication service on all resources that require access to a customer’s account or betting functionality. To authenticate you’ll need to supply a customer's 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. Click here to read the Sessions API document. How long will a customer's session ticket last before it expires? The ticket will normally expire in two hours if it is not used, but if it is in use, the expiration time is eight hours. When I use the Sessions API to log out a user, why is there no corresponding message in the response body? After executing your request, under the Response tab you will not see anything in the response other than the '200 - OK' HTTP status code in the header. This indicates that you have successfully deleted the ticket and ended the session. Why do I have to select a representation type for logOut when there is no response supplied in the body? Although this request will not produce a message in the response body if successful, you will need to define a representation as this is the format in which an error will be transmitted if your request fails. Where do I find a customer to use with the Sessions API? To use the Sessions API, you will need to have created a customer account first. When and why should I supply an authentication ticket (who-ticket) with the Numbers API? The getRandomNumbers method operates in two distinct ways – Demo mode and Live mode. In Demo mode, where no money is involved, the who-ticket is not required and can be used without it. In Live mode, when there is a financial outcome, you must supply a valid authentication and the who-ticket must be applied. Important: The service must not be used in Live mode without a who-ticket. I don’t have access to Numbers API. How do I request access to use this service? The Numbers API is a Private API and therefore not automatically available to developers on the Developer Portal. To use this API, you will need to create a ticket via our ticketing system. What are the differing status types for customer accounts? The following status types exist: A - Active - all operations allowed S - Suspended - no operations allowed L - Locked - too many password failures W - Withdrawable - only allowed to withdraw (no DEP/BET) T - Transactions blocked - no deposits/withdrawals allowed B - Betting blocked - no betting allowed P - Password - must change password I - In use - in use (telebet/cashbet) X - Batch Generated - reserved block of accounts C - Closed - account has been closed N - Pending - account is pending through multi-part registration How can I see my API key? Due to security reasons we do not display the API keys in the My Accounts page or any other page of our William Hill Labs Developer Portal. API keys will be sent to you in a separate email after you have been approved to take part in out Developer Program. I keep getting back events in the response to my call and some of these are not real. What is the purpose of these? The traders create placeholder events before a cup draw (for example, to speed up getting the markets live as soon as possible for punters to bet upon). These are not real and you should ignore them when parsing the response. When retrieving a single event (football match) and using the headlineSummary parameter, can I safely assume that the "90 Minutes” market will always appear first? It depends on the event: For match events it will prob be 90 mins or match betting live depending on that status of the event For outright events it could be anything
