www.williamhill.com·Developer portal → developer.williamhill.com
6 APIs across 6 product groups.
| I want to... | Use | Why |
|---|---|---|
| Read sports competitions, events, markets and prices | SportsData API | SportsData API returns competition, event, market and selection data including prices for building a betslip |
| Authenticate a customer and get a session ticket | Sessions API | Sessions API logs in a customer and issues, validates and revokes the authentication ticket other calls rely on |
| Place bets and read bet history | Bets API | Bets API places single, multiple and complex bets, validates betslips, and returns settled and unsettled history |
| Read a customer's balance, payments and card details | Accounts API | Accounts API queries account details, balance, payments and Plus Card status for the logged-in customer |
| Resolve a UK address, country or currency | Locations | Locations returns address lookups and reference data for countries and currencies to populate registration forms |
What agents get from Jentic-routed access to this vendor.
Setup
Instead of wiring each William Hill API against its whapi.com sandbox host and stitching the session, sports data, betting and account calls together by hand, you install Jentic One once and add the APIs you need from the Jentic directory, then your agent calls them.
Permission scoping
Your own Jentic One rules decide which operations each API exposes to the agent. You can allow read-only sports data and balance lookups while withholding write actions such as placing bets or reporting a Plus Card lost until you add them explicitly.
Credential isolation
Where an API needs a key, such as the Locations apiKey, your own Jentic One instance stores it once, encrypted, and injects it at execution time so it never enters the agent's prompt, logs, or context. Session tickets from the Sessions API are handled the same way.
Specific to using William Hill APIs through Jentic.
What can an agent build across the William Hill APIs?
An agent can run a full sportsbook flow: authenticate a customer with the Sessions API, read competitions, events, markets and prices from the SportsData API, place and track bets with the Bets API, and query balances, payments and card details with the Accounts API. The Locations and Numbers APIs supply supporting address, reference and random-number data.
Do these APIs share one set of credentials?
No. The Locations API uses an apiKey header, while the other five rely on a session ticket issued by the Sessions API for any call that touches a customer's account or betting. You authenticate once through the Sessions API and reuse the ticket across the account, betting and sports data calls that require it.
Which API should an agent start with?
For anything customer-specific, start with the Sessions API to obtain an authentication ticket. For read-only market data an agent can call the SportsData API directly, then move to the Bets and Accounts APIs once a session exists.
Are these production or sandbox endpoints?
The specs point at the whapi.com sandbox host. Treat them as test endpoints for building and validating flows, and confirm production hosts and credentials with William Hill before handling real customer accounts or stakes.
BOOK A DEMO
Browse thousands of APIs and connect them all to your agent with Jentic One. One layer, one credential — every API your agent needs.
For Agents
An agent can authenticate a customer session, read sports competitions, events, markets and prices, place single, multiple or complex bets and check bet history, then look up account balances, payments and card details across William Hill's connected APIs. It can also resolve UK addresses, countries and currencies and generate random numbers for use inside those flows.
William Hill exposes a bookmaker's core systems as separate but connected REST APIs, so the sports data, session, betting, account and location functions that normally sit behind a single betting site are individually addressable. This lets an agent assemble a complete authenticate, price, bet and reconcile flow rather than integrating one monolithic endpoint.
Use for: Programmatic sports betting against the William Hill sportsbook: reading competition, event and market prices, authenticating a customer session, placing and tracking bets, and querying account balances, payments and card details.
Not supported: deposits or withdrawals, casino or gaming products, non-UK address lookup, real-time price streaming, webhook subscriptions, production credentials
Credentials: Auth is not uniform across the portfolio: the Locations API requires an apiKey header, the other five APIs declare no static auth in their specs and instead rely on a session ticket obtained from the Sessions API for calls that touch a customer's account or betting functions.
All 6 William Hill OpenAPI specs are third-party and indexed by Jentic, kept validated and agent-ready.
William Hill's whapi.com developer platform exposes its sportsbook as a set of REST APIs covering sports and pricing data, customer accounts, bet placement, session authentication, address and location lookup, and random number generation. Together the six APIs let an application read live competition, event, market and selection data, authenticate a customer session, place and track bets, and query account balances and payments. All endpoints run against the whapi.com sandbox host and return structured JSON that agents can parse directly.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the William Hill APIs, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fwhapi.com" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fwhapi.com" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Once connected, ask your agent something like: “authenticate a William Hill customer, read event prices, and place a bet”.
Each workflow spans multiple William Hill APIs. Jentic routes each operation to the right API automatically.
Authenticate then place a bet
Log a customer in to obtain a session ticket, read the current markets and prices for an event, then place a single or complex bet against the priced selection.
Call POST /tickets on the Sessions API to log the customer in, GET the event's markets from the SportsData API, then POST /bet/single on the Bets API for the chosen selection
Sessions API + SportsData API + Bets API
Reconcile bets against balance
After placing bets, read the customer's bet history and compare it against their account balance and payments to confirm stakes and returns were applied.
Call GET /history on the Bets API for settled and unsettled bets, then GET /account/balance and GET /account/payments on the Accounts API to reconcile
Bets API + Accounts API
Price a competition's events
Pull the events and market groups for a competition and enrich each with the customer's account context so an agent can surface relevant markets for a logged-in session.
Validate the session ticket with GET /tickets/{tgt} on the Sessions API, then GET /competitions/{competitionId}/events/ and marketgroups from the SportsData API
SportsData API + Sessions API
Populate registration then open an account view
Resolve a UK address and reference currency for a new customer, then read the resulting account details once the customer is signed in.
Call GET /address/lookup/ and GET /currencies/ on Locations to fill the form, then GET /account on the Accounts API for the signed-in customer
Locations + Accounts API
Intent-based discovery
An agent searches the Jentic directory by intent, such as 'log in a customer' or 'place a single bet', and Jentic returns the matching William Hill operation with its input schema, so the right API is selected without reading the reference docs.
What is out of scope for this portfolio?
The APIs cover sports betting, accounts, sessions, and location and number utilities. They do not cover deposits or withdrawals, casino or gaming products, non-UK address lookup, real-time price streaming, or webhook subscriptions.
How does Jentic help an agent use these APIs together?
Once Jentic One is installed, an agent finds and adds any of the William Hill APIs from the Jentic directory by intent, and your own Jentic One instance injects any stored key at execution time. That lets an agent chain the Sessions, SportsData, Bets and Accounts APIs without hardcoding hosts or handling secrets in its context.
All 4 are in the Jentic catalogue with the same one-credential, intent-search pattern.