Learn How to Use This Website

• Access the website: Use your preferred internet browser to navigate to the website's URL.
• Explore the homepage: Find the latest lottery results, updates, and news. Filter results by game and date to view archived draw results.
• Menu bar: Provides options:
  • Home: Return to the homepage.
  • Detailed Results: In-depth breakdown of recent SA lottery games.
  • Generate API Key: Get an API key to retrieve the latest lottery results and access API endpoints.
  • Buy Subscription: Here you can purchase a monthly subscription plan to access API services. Choose from Starter, Basic, or Professional tiers.
  • API Documentation: This is the API documentation for the ResultsZA API endpoints.
  • Other Lottery Games: A dropdown menu containing non-SA lottery games. Currently includes UK 49's — more games coming soon.
  • Subscriber Portal: A white pill button on the right side of the menu bar. Click it to log in to your personal subscriber portal where you can manage your subscription, view invoices, and configure alerts.

• Access the "Detailed Results" page: Click on "Detailed Results" in the menu bar.
• Understand the page: Detailed data for different lottery games. Each game's results are displayed separately.
• Breakdown of results includes:
  • Game Type, Draw ID, Date, Winning Numbers, Total Pool Size, Total Sales, Draw Machine, Next Draw Date.
  • Next Jackpot: Estimated jackpot for the next draw (in Lotto Results).
  • Division Details: Info on each winner division.

• Draw Details: Note the date and draw ID in "Detailed Results" for accuracy.
• Next Draw: Check "Next Draw Date" for upcoming lottery games.
• API Usage: Monitor your monthly API usage to ensure you stay within your subscription limits.

API key generation: Generate your unique API key to access our services.

Features:

Subscription Plans:

• Starter: 300 API calls per month - Ideal for testing and personal use
• Basic: 1,500 API calls per month - Perfect for regular usage
• Professional: 6,000 API calls per month - For higher volume applications
• Unlimited: Unlimited API calls per month* - Production / high usage (fair use policy and rate limits apply)

Important: Monthly subscriptions provide a fixed number of API calls per month (or unlimited with fair use for the Unlimited plan). Unused calls do not carry over to the next billing cycle. When your subscription expires, you have a 7-day grace period to renew and continue using any remaining calls. After the grace period, unused calls are permanently lost and API access is suspended. If you exhaust your calls before your billing cycle resets, you can purchase a top-up package or upgrade to a higher tier. See the Subscriptions, Billing & Top-ups section above for full details.

*Unlimited is subject to fair use and API rate limits (60 requests/minute) to protect service availability. Exceeding the rate limit triggers a 5-minute cooldown period.

How Monthly Subscriptions Work

When your subscription is activated, you receive a fixed number of API calls to use over the next 30 days. Your usage counter resets automatically at the start of each new billing cycle. Unused calls do not carry over. Any calls left at the end of a billing cycle are forfeited, so it is worth planning your usage accordingly.

Grace Period

When your subscription expires, you enter a 7-day grace period. During this time you can still use any remaining API calls from your last billing cycle and renew your subscription at the standard price. If you do not renew within those 7 days, your subscription is marked as expired, API access is suspended, and any unused calls are permanently lost.

Top-up Calls

If you burn through your monthly call allowance before your billing cycle resets, you can purchase a top-up package to carry you through the remainder of the month. Top-up calls are added directly on top of your subscription limit and become available instantly after payment is confirmed.

A few things to know about top-ups:

• Top-up calls reset at the same time as your monthly usage counter and do not carry over to the next billing cycle.
• Top-up rates are intentionally higher per call than subscription rates. They are designed as a short-term safety net, not a replacement for a higher subscription tier. If you regularly need more calls, upgrading your subscription will save you money.
• Top-up purchases are non-refundable once activated.

Upgrading Your Plan

You can upgrade to a higher tier at any time through the Buy Subscription page. When you upgrade mid-cycle on an active multi-month subscription, you only pay a pro-rata amount rather than the full monthly price of the new tier.

Pro-rata pricing works like this: the system calculates how many days are remaining in your current billing cycle and charges you the price difference between your current tier and the new tier, scaled to cover only those remaining days.

If you are renewing an expired subscription or purchasing a single-month subscription for the first time, the full monthly price of the chosen tier applies regardless of the calendar date.

Monitoring Your Usage

You can check your current API call usage, subscription tier, and billing cycle dates at any time using the /api/check_subscription endpoint or through the subscription status page. This check does not count against your monthly call limit.

The Subscriber Portal is your personal account dashboard. Once you have generated an API key and purchased a subscription, the portal gives you full visibility and control over your account — without needing to contact support for most tasks.

Accessing the Portal

Click the Subscriber Portal button in the top-right corner of the menu bar on any page of the website. This takes you to the login screen.

Dashboard

The dashboard gives you an at-a-glance view of your account:

• Plan & Status: Your current subscription tier and whether it is active, pending, or expired.
• API Calls: How many calls you have made this billing period.
• Usage bar: A visual indicator of how much of your monthly quota you have used.
• Primary API Key: View, reveal, and copy your API key directly from the dashboard.
• Recent Invoices: Your last five paid invoices with a direct PDF download link.

Subscribing & Upgrading

If you do not yet have an active subscription, a Subscribe button appears on the dashboard and the Subscription page. Click it to open the plan selector, choose your tier and billing period, and proceed to secure checkout via iKhokha. Once payment is confirmed your subscription activates automatically.

If you already have an active subscription the button changes to Upgrade, allowing you to move to a higher tier at any time.

Completing a Pending Payment

If you started a checkout but did not complete the payment, the button changes to Complete Payment. Clicking it creates a fresh payment link for the same package and takes you straight back to the payment gateway — no need to fill in the form again.

Pending payments also appear on the Invoices page with a Complete Payment button next to each one.

Invoices

Every confirmed payment generates a PDF invoice. Go to the Invoices page to see your full billing history. Click PDF next to any successful payment to download a branded tax invoice showing the plan, period, amount paid, and API call allowance.

API Keys & Sub-keys

The API Key page shows your primary key and lets you create up to 10 sub-keys. Sub-keys are useful if you want to use the API from multiple applications or share access with team members without revealing your primary key. Each sub-key can be labelled, viewed, and revoked independently. A copy button next to each key lets you copy it to the clipboard instantly.

Telegram Alerts

You can link your Telegram account to receive instant notifications for subscription events, payment confirmations, and API activity.

• Go to Account → Telegram Alerts and click Link via Telegram.
• This opens our ResultsZA_bot in Telegram. Send the bot the /start message and your account will link automatically.
• Once linked, a green Linked badge appears and a mute toggle lets you silence notifications without unlinking your account.
• You can unlink at any time by clicking Unlink Telegram on the same page.

Account Settings

• Change password: Update your portal login password from the Account page.
• Change email: Request an email address change. A confirmation link is sent to your new address before the change takes effect.
• Forgot password: Use the Forgot password? link on the login page. A reset link valid for 1 hour will be emailed to you.

Access UK 49's results via the Other Lottery Games item in the menu bar. UK 49's is a fixed-odds betting draw operated by 49's Ltd (UK) — it is not affiliated with the South African National Lottery.

• Archive Search: On the UK 49's page you can filter results by draw type and date range going back to the very first draw.
• API Access: Use the /api/get_uk49s_results endpoint or the standard /api/get_results_by_game endpoint with any of the draw names above.
• Booster Ball: All draws include a Booster Ball (separate from the 6 main numbers). Historical draws before 2007 do not have a recorded Booster Ball.