Quick start
New here? Here's the lay of the land in four steps.
Check results
Open in the menu and pick a game, or browse the latest draws on the home page.
Play with tools
Generate lucky numbers, explore hot & cold numbers, all under .
Create an account
Under → Create Account. It's free: set your password from the link we email you, then generate your key and choose a plan in My Dashboard.
Build & subscribe
Read the docs, copy a script, then choose a plan to start pulling live results.
Finding results
Every game has its own page, grouped by country in the Results menu.
- Home page: the latest draw for each South African game at a glance, plus an archived-results filter.
- Lottery Results menu: grouped by region: South Africa, United Kingdom, United States, Europe and Africa. Pick any game to open its dedicated page. Horse Racing Results has its own menu item.
- Each game page shows: the latest winning numbers and bonus ball, the prize-division breakdown, jackpot and sales stats, and an Archived Draw Results filter.
- Archive filter: choose a date range and pass the quick human check (Cloudflare) to pull historical draws for that game.
Supported games
Lottery games and horse racing results across multiple regions, each with a dedicated results page and API endpoint.
Open any game from the menu or , or fetch them programmatically. See the API Documentation.
Tools
Free helpers under the menu.
Daily Lotto Predictor
A free daily guessing game at . Free to play, no prizes, just bragging rights.
How to play
- Pick 5 numbers from 1 to 36 on the number grid.
- Add the name you want on the leaderboard and your email address.
- Get your picks in before 8pm. That is when entries close, an hour before the roughly 9pm draw.
- One entry per person per draw. Come back tomorrow and play again.
Confirming your email
- Your first entry is stored and scored straight away, so you never miss a draw while checking your inbox.
- It stays off the leaderboard until you click the confirm link we email you.
- Once confirmed, every entry you have already made counts towards the boards.
What you score
The two boards
- Top Scorers: most points this month. Everyone starts fresh on the 1st, so a new player always has a live shot at the top.
- Longest Streak: most days played in a row. Miss a day and you start again. Entering is what counts, not scoring, so a blank night does not break your streak.
After the draw
- We score your picks automatically once the Daily Lotto result lands and email you how you did.
- If the result is published late, your entry simply waits and is scored when it arrives.
- Every result email carries a link to your own history and a one-click unsubscribe.
Good to know
- There is no prize. This is a free game for bragging rights, not a lottery or a competition.
- Entering after 8pm puts you in for the next draw, and the confirmation tells you which draw you are in for.
- You need no account and no API key. It is free, separately from any subscription.
The API
A REST API for live lottery data. Everything API-related lives under the menu.
Getting started
- Create Account: sign up free and set your password, then generate your API key and choose a plan in My Dashboard.
- API Documentation: full endpoint reference with live "Try it" examples.
- Scripts: copy-paste Python & JavaScript snippets for every endpoint.
- Pricing: see what each plan and top-up costs. You buy in My Dashboard under Services > API > Billing.
What you can do
/check_api_key_balance endpoint (free; does not count against your limit).Subscriptions, billing & top-ups
How billing works for every ResultsZA service: API plans, top-ups, webhook push, and what stays free.
Billing at a glance
| Service | How it's billed | Cost |
|---|---|---|
| API subscription | Monthly, call limit resets each cycle | R149 to R1,000 / month |
| API top-ups | Once-off, added instantly | R60 / R150 / R249 |
| Webhook push | Prepaid term of 1, 3, 6 or 12 months | R599 / month |
| Results pages, tools, balance checks | No billing | Free |
Monthly subscriptions
When your subscription activates you get a fixed number of API calls for each calendar month you have paid for. Your counter resets on the same day each month. Nothing renews automatically, and you buy, extend or change plans in My Dashboard. Unused calls do not carry over.
| Plan | Price / month | Calls | Per call |
|---|---|---|---|
| Starter | R149 | 300 | R0.50 |
| Basic | R299 | 1,500 | R0.20 |
| Professional | R599 | 6,000 | R0.10 |
| Unlimited | R1,000 | Unlimited* | n/a |
*Unlimited is subject to fair use and a 60 requests/minute rate limit; exceeding it triggers a 5-minute cooldown.
Top-up calls
Run out before your cycle resets? Buy a top-up in My Dashboard under Services > API > Billing (Buy extra calls). It is added on top of your limit straight away, needs an active plan, resets with your monthly counter and doesn't carry over.
Changing your plan
Open > Services > API > Billing. You'll see Extend, Upgrade and Downgrade (Starter has no Downgrade and Unlimited has no Upgrade).
- Upgrade: starts as soon as you pay and your end date stays the same. You pay the monthly price difference for each billing month left, with the current month counted in full.
- Extend: adds months after your current end date, any time, so renewing early never wastes days. Your calls still reset monthly and unused calls don't carry over.
- Downgrade: starts as soon as you pay. The time left on your current plan and this month's unused calls (including top-ups) are lost, with no refund. If you can, wait until your plan ends.
Webhook push billing
The Webhook Push Plan is a flat R599 per month, whichever games you select. You pay upfront via our secure payment gateway for the term you choose:
| Term | Total |
|---|---|
| 1 month | R599 |
| 3 months | R1,797 |
| 6 months | R3,594 |
| 12 months | R7,188 |
Renewing early never wastes time: new months are added on top of your remaining days. Push is billed separately from the API subscription, so you can run either service on its own or both together. Subscribe or renew in My Dashboard under Services > Webhook Push > Billing; prices are on the Webhook Push Pricing page.
Where you buy
Every purchase is made in , on the Billing tab of the service: Services > API, Services > Webhook Push or Services > Number Checker. The public pricing pages only show prices. You pay on iKhokha's secure payment page and nothing renews automatically.
Voucher codes
Have a voucher code? Enter it in the Have a voucher code? box on the Billing tab of the service you are buying, then press Apply. A quick human check runs first. A code can be for one service, for the API and Webhook Push together, or for all services, and a code used on a service it is not for is refused. Discount codes take a percentage off; complimentary codes give free months and are for first-time subscribers only. Vouchers do not apply to API top-ups.
Cancelling
Open > Services, choose the service and press Cancel subscription at the bottom of its Overview. By default you keep access until your end date, reminders stop and you can Resume before then. Or choose End it now: access stops straight away and the remaining time and unused calls are forfeited. You confirm by typing your account email. No refunds are issued for the current billing period.
What's free
Free API calls with Backlink Rewards
Earn free API calls by linking to ResultsZA from a website you own. The calls stack on top of your plan, so it is a simple way to lower what you spend, or to run on free calls alone.
How it works
Grab your snippet
Open and go to Backlink Rewards. Copy the ready-made link snippet, it already contains your unique reference code.
Add the link
Paste it on a page of a website you own or manage. Keep the rel="sponsored" attribute that comes with it.
Earn calls
We verify the link and add 10 free API calls every month for it, on top of your plan.
The numbers
| Detail | Value |
|---|---|
| Free calls per verified link | 10 per month |
| Links per domain | Up to 2 (all subdomains count as one domain) |
| Total links | Up to 20 |
| Most free calls per month | 200 |
| Cost | Free, added on top of your plan |
Keeping your calls
We re-check your links daily. As long as a link stays live, the free calls keep coming and reset each month.
The rules
My Dashboard
Your account dashboard. Click Log in (top-right of the menu), or go straight to /portal/login. Once you are logged in, click the round icon with your initial and choose My Dashboard.
What you can do
- Overview: your API balance and every service you have (API, Webhook Push, Number Checker) with its end date and an Extend or Renew button.
- Services: each service has its own tabs. API: Overview, Billing, API Key and API requests report. Webhook Push: Overview, Settings and Billing. Number Checker: Overview, My numbers, Results and Billing. You buy, extend, upgrade or downgrade on the Billing tab and cancel from the Overview tab.
- API Key: your key is not created at sign-up. Press Generate API key when you are ready, then create up to 10 labelled sub-keys you can revoke independently.
- API requests report: every request made with your key, per billing period, with a CSV download (kept for 12 months).
- Backlink Rewards: earn free API calls for links to ResultsZA.
- Invoices: download PDF tax invoices for every confirmed payment, including the Number Checker, and finish a pending payment.
- Notifications: choose which alerts you get by email and Telegram, and link or unlink the ResultsZA Telegram bot.
- Account: change password or email, or delete your account (Danger Zone), which revokes keys, ends every service with no refund, and removes your data.
Webhook Push Plan
Receive lottery and horse racing results posted directly to your server. No polling, no missed draws. South African lottery pushes wait for the official prize breakdown so each one carries the full division table; every other feed is sent as soon as we capture the result. Full detail on timing.
Create an account
If you do not have one yet, create a free account and set your password. Your account is linked to your push subscription.
Subscribe
Log in to My Dashboard (or create a free account), open Webhook Push under Services, choose a subscription period and pay via our secure payment gateway. Prices are on the Webhook Push Pricing page.
Note your signing secret
Your webhook signing secret appears on the payment confirmation page. Copy it immediately. You can also reveal it at any time on the Settings tab of Webhook Push in My Dashboard.
Configure your endpoint
Log in to My Dashboard, open Services > Webhook Push > Settings, paste your webhook URL, select the games you want, and click Save.
Logging in to My Dashboard
Click Log in (top-right of the menu), or go straight to /portal/login. Log in with your email address and your password. First time, or never set a password? Use Forgot password on the login page.
Finding the Settings tab
Once logged in, open Services in the left menu, choose Webhook Push and then the Settings tab.
- Webhook URL field: paste the endpoint on your server that will receive payloads (use HTTPS).
- Games to Receive: a card for each country/region with checkboxes. Tick the games you care about. Use "Select all" to toggle a whole group at once.
- Signing Secret: click Reveal Secret to view your HMAC key. Copy it into your server config.
- Test Webhook: sends a live test payload to your URL so you can confirm your endpoint is reachable before any real results arrive.
- Delivery Log: lists your deliveries, newest first and 20 per page, with status (Delivered / Failed / Pending), attempt count, and timestamps. Entries are kept for 15 days.
Your webhook URL requirements
- Should be HTTPS. We strongly recommend it: plain HTTP sends the payload and its signature unencrypted.
- Must return a 2xx HTTP response within 10 seconds.
- Can be any path on your server, e.g.
https://myapp.com/webhooks/resultsza.
Verifying incoming payloads
Every POST from ResultsZA includes an X-ResultsZA-Signature header. Compute HMAC-SHA256(raw_request_body, signing_secret) and compare it to that header. Reject anything that does not match. Verify against the raw request bytes, exactly as received: if you parse the JSON and re-serialise it the bytes change and the signature will never match. The header value includes the sha256= prefix, so compare against the full string.
import hmac, hashlibexpected = "sha256=" + hmac.new(secret.encode(), body_bytes, digestmod=hashlib.sha256).hexdigest()if not hmac.compare_digest(expected, request.headers.get("X-ResultsZA-Signature", "")): abort(403)
The request also includes X-ResultsZA-Game (game identifier) and X-ResultsZA-Event (result.published for real results, result.test for a Test Webhook send) headers so you can route or filter without parsing the body first.
Retry policy
If your endpoint does not respond with 2xx, ResultsZA tries again. Each delivery gets 3 attempts in total (the first plus 2 retries), spaced at least 10 minutes apart. After the third failed attempt the delivery is marked failed and you receive an email notification. The Delivery Log on the Webhook Push Settings tab shows the last 15 days so you can see exactly what happened and when.
Delivery is at-least-once
Treat every delivery as at-least-once: the same result can arrive more than once (for example if a retry overlaps a slow but successful response). De-duplicate on the game plus the draw identifier (draw_date or draw_number, plus draw_time for games that draw several times a day; race_key for horse racing) and make your processing idempotent, so a repeat delivery is a harmless no-op.
Selecting games
On the Webhook Push Settings tab, games are grouped by country: SA Lottery, Nigeria (Baba Ijebu), Ghana, Kenya, UK 49s, EuroMillions, Ireland (Irish Lotto), US Lottery, Horse Racing, and Russia (Gosloto). Only the games you tick will generate deliveries. Unselected games are silently skipped, so you only receive what you need.
View full payload reference for all games: includes field tables, number formats, and a live interactive example for every game.
Number Checker
Save the numbers you play once, and we check every draw for you and message you when you win. R29 a month. Learn more on the Number Checker page.
Signing up
- Create a free account at /signup with your name and email. It is the same account you use for the API and Webhook Push.
- Confirm your email and set your password using the link we send you. Sign-ups that are not confirmed within 48 hours are removed.
- Log in at /portal/login, open Services > Number Checker in My Dashboard, save your lines on My numbers and pay on the Billing tab (1, 3, 6 or 12 months).
Adding your lines
- Add each line you play for Daily Lotto, Lotto or Powerball. You can save up to 50 lines per game.
- Tick the extras that line was played for: Lotto Plus 1 and Lotto 5 Max for Lotto, and Powerball Xtra for Powerball. We only report wins for the games you ticked.
- Edit or delete a line at any time. Press Cancel (or the ×) on an open form to close it without saving.
Choosing when a line is checked (draw schedule)
Every line has a Draw schedule when you add or edit it:
- Start checking from: pick the first draw from the calendar. It only shows the days that game is drawn (every day for Daily Lotto, Wednesday and Saturday for Lotto, Tuesday and Friday for Powerball), from the next draw that has not closed, up to a year ahead.
- Number of draws: choose Until I stop it, or 1 to 10 draws. With a number of draws, the line is checked only for those draws and then pauses by itself, showing Paused: run complete. Your numbers stay saved.
- The line shows where it is: Starts Sat 7 November before its first draw, and Draw 3 of 10, final draw Sat 5 December while it runs.
- Start a new run sets up the next run for the same numbers. You can do this before the current run ends: the new run starts after the final draw, and the remaining draws of the current run are still checked.
Run reminders (optional)
Once you choose a number of draws, you can tick Remind me one draw before my final draw, Remind me on the day of my final draw, or both. Reminders are sent at 08:00 on the day, by the channels you selected on the Notifications page, so you have time to play again before the draw closes. A paused line gets no reminders.
Pausing a line
Press Pause on a line to stop checking it, for example when you are not playing it for a while. Press Resume to start checking it again. Your numbers stay saved while paused.
Pausing does not move a draw schedule: the run still ends on its final draw. Starting a new run resumes a paused line.
Connecting Telegram (optional)
Open the Notifications page in My Dashboard and follow the steps to connect the ResultsZA bot. To disconnect, send /unlink to the bot. Email works without Telegram.
Reading your results
- You get one email and/or Telegram message per draw day, covering every game you played that day.
- It is sent once the lottery operator publishes the prize amounts. If they are not published by 12:00 the next day, we send the message anyway, with your matches, and say the amounts are not published yet.
- There is no fixed delivery time.
- The operator's published results and your physical ticket decide any prize.
Renewing
Renew at any time in My Dashboard under Services > Number Checker > Billing. If you renew early, the months are added to your current end date. Your expiry date is the last day of service, and the service runs until 23:59 on it. We remind you 7 days and 3 days before, and on the expiry day. If your subscription ends, checking and messages stop, but your saved numbers and history are kept until you delete your account.