# ResultsZA

> ResultsZA is a South African lottery results platform and REST API service. It provides real-time and historical results for all major South African National Lottery games, accessible via a website and a developer API.

## What ResultsZA Does

ResultsZA publishes up-to-date results for every South African lottery draw and provides a REST API that developers can integrate into their own apps, websites, and bots. The site is live at https://resultsza.co.za.

## Lottery Games Covered

- Lotto (Wednesday and Saturday draws)
- Lotto Plus 1
- Lotto Plus 2
- Powerball (Tuesday and Friday draws)
- Powerball Plus
- Daily Lotto (daily draws)
- Daily Lotto Plus (daily draws)
- UK49s Lunchtime
- UK49s Teatime

All results are sourced from official South African National Lottery data and updated within minutes of each draw.

## Website Pages

- [Home — latest results](https://resultsza.co.za/) — live results for all games
- [Detailed results](https://resultsza.co.za/detailed) — full draw breakdowns with payouts and rollovers
- [Historical results archive](https://resultsza.co.za/) — past draws for all games
- [Number checker](https://resultsza.co.za/check_numbers) — check your numbers against any past draw
- [API documentation](https://resultsza.co.za/api_docs) — full developer reference
- [Get an API key](https://resultsza.co.za/generate_api_key) — free key generation with email verification
- [Subscription plans](https://resultsza.co.za/buy_now) — pricing for API access
- [How it works](https://resultsza.co.za/how_to) — guide to using the API

## REST API

The ResultsZA API provides programmatic access to South African lottery results. All endpoints require an `api_key` query parameter.

Base URL: `https://resultsza.co.za`

### Endpoints

**Get latest results (all games)**
`GET /api/get_latest_results?api_key=YOUR_KEY`
Returns the most recent draw results for every game.

**Get results by game and date**
`GET /api/get_results_by_game?api_key=YOUR_KEY&game=Lotto&date=2026-05-17`
Returns draw results for a specific game on a specific date.
Supported game values: `Lotto`, `Lotto Plus 1`, `Lotto Plus 2`, `Powerball`, `Powerball Plus`, `Daily Lotto`, `UK49s Lunchtime`, `UK49s Teatime`

**Get UK49s results**
`GET /api/get_uk49s_results?api_key=YOUR_KEY`
Returns the latest UK49s Lunchtime and Teatime results.

**Check API key balance**
`GET /api/check_api_key_balance?api_key=YOUR_KEY`
Returns remaining call credits and subscription expiry for the key.

**Hot and cold numbers**
`GET /api/get_hot_cold_numbers_stats?api_key=YOUR_KEY&game=Lotto`
Returns frequency statistics showing the most and least drawn numbers.

**Number frequencies**
`GET /api/get_number_frequencies?api_key=YOUR_KEY&game=Powerball`
Returns how many times each number has been drawn historically.

**Random number generator**
`GET /api/generate_random_numbers?api_key=YOUR_KEY&game=Lotto`
Generates a random set of numbers for the specified game.

## Getting an API Key

1. Go to https://resultsza.co.za/generate_api_key
2. Enter your full name and email address
3. Complete the security check
4. Click the verification link emailed to you
5. Your API key is delivered immediately — no credit card required to generate a key

## Subscription Plans

All plans are monthly subscriptions billed in South African Rand (ZAR). Secure payment checkout.

| Plan | Price | Monthly Calls | Best For |
|---|---|---|---|
| Starter | R149/month | 300 calls | Testing and proof of concept |
| Basic | R299/month | 1,500 calls | Small apps and bots |
| Professional | R599/month | 6,000 calls | Production usage |
| Unlimited | R1,000/month | Unlimited* | High-volume production |

*Unlimited plan is rate-limited to 60 requests per minute to prevent abuse.

Top-up packages are also available for subscribers who exhaust their monthly allocation before renewal.

## Subscriber Portal

Every API key holder gets access to a self-service subscriber portal at https://resultsza.co.za/portal/login.

**Login:** Use your email address as the username. First-time login uses your API key as the temporary password — you are prompted to set a permanent password on first sign-in.

**Portal features:**

- **Dashboard** — live view of your current subscription status, calls remaining, and usage statistics
- **Subscription management** — view your active plan, expiry date, remaining calls, and upgrade or purchase a top-up package without contacting support
- **Sub-keys** — create additional API keys (sub-keys) under your account for use in different apps or environments; each sub-key can be labelled and revoked independently
- **Invoices** — view and download PDF invoices for all payments
- **Account settings** — change your password, update your email address
- **Telegram notifications** — link your Telegram account to receive proactive alerts including subscription expiry warnings, API call exhaustion alerts (so you can top up before your service pauses), and other important service announcements
- **Password reset** — self-service password reset via email at https://resultsza.co.za/portal/forgot-password

## Contact and Support

- Support email: info@resultsza.co.za
- Website: https://resultsza.co.za
- Subscriber portal: https://resultsza.co.za/portal/login