Notice: This API provides the latest draw results for all lottery game types. You will be able to pull draw results for specific game types as well as for specific draw dates. Currently there is a monthly quota limit set at 10 FREE API request tokens per month, per API key. If you would like more tokens, you will need to buy a token bundle here - Buy Token Bundle

Generate Your API Key

To access the latest lottery results through our API, you can generate an API key using the button below. Be sure to copy and save your key before closing the window!

How to Use the API

Available lottery GAME_NAMES for querying:

Daily Lotto
Lotto
Lotto Plus 1
Lotto Plus 2
Powerball
Powerball Plus

To fetch the latest lottery results, use the following request:

curl -i "https://resultsZA.co.za/api/get_latest_results?api_key=YOUR_API_KEY"

To get results for a specific date, append the &date=YYYY-MM-DD parameter:

curl -i "https://resultsZA.co.za/api/get_latest_results?api_key=YOUR_API_KEY&date=2023-03-20"

To retrieve results for a particular game, use:

curl -i "https://resultsZA.co.za/api/get_results_by_game?api_key=YOUR_API_KEY&game=GAME_NAME"

To get results for a specific game on a specific date, use:

curl -i "https://resultsZA.co.za/api/get_results_by_game?api_key=YOUR_API_KEY&game=GAME_NAME&date=YYYY-MM-DD"

Please replace YOUR_API_KEY with your actual API key and GAME_NAME with the name of the lottery game (e.g., "Lotto", "Powerball"). Ensure the date format is YYYY-MM-DD for date-specific queries.

Response Format

The response will be a JSON object containing the draw results. Depending on the API endpoint called, the structure is as follows:

get_latest_results

Returns the latest results for all games or for a specific date. The response structure:

status: A string indicating the success status of the API request.
results: An object with each key corresponding to a game type (e.g., "daily_lotto_results", "powerball_results"), and its value containing:

date: The date and time of the draw in ISO 8601 format (UTC).
draw_id: A unique identifier for the draw.
draw_machine: Identifier for the machine or system used for the draw.
game_type: The name of the lottery game.
total_pool_size: The total prize pool amount for the draw in ZAR.
total_sales: The total ticket sales amount for the draw in ZAR.
winning_numbers: An array of integers representing the winning numbers.
powerball / bonus_ball: The Powerball number or the Bonus ball, if applicable (can be null depending on the game type).
next_draw_date: The date and time for the next draw in ISO 8601 format (UTC).
divisions: An array of objects for each prize division, containing:

division: The name or identifier of the division.
winners: The number of winners in that division.
winning_amount: The prize amount won per winner in that division in ZAR.

get_results_by_game

Returns the results for a specific game. The response structure:

status: A string indicating the success status of the API request.
results: An array of objects, each representing a draw for the specified game, with fields:

draw_id: A unique identifier for the draw.
game_name: The name of the lottery game (e.g., "Lotto").
draw_day: The day of the week when the draw occurred.
draw_date: The date and time of the draw in ISO 8601 format (UTC).
winning_numbers: An array of integers representing the drawn numbers.
powerball / bonus_ball: The bonus ball number for the draw, if applicable or the powerball number for the draw, if applicable.

Example of a Successful JSON Response for a Specific Game Query:

My query was "curl -i "https://resultsZA.co.za/api/get_results_by_game?api_key=YOUR_API_KEY&game=Lotto&date=2006-06-10"


{
    "status": "success",
    "results": [
        {
            "draw_id": 626,
            "game_name": "Lotto",
            "draw_day": "Saturday",
            "draw_date": "2006-06-10T20:00:00Z",
            "winning_numbers": [25, 32, 34, 36, 41, 44],
            "bonus_ball": 8
        }
    ]
}

Here is another example of a Successful JSON Response for a Specific Draw date query. When you look for a specific draw date, it will list only the games that were drawn on the date but it will also include the winning divisions and the amounts won:

My query was "curl -i "https://resultsZA.co.za/api/get_latest_results?api_key=YOUR_API_KEY&date=2019-03-23"


{
    "status": "success",
    "results": {
        "daily_lotto_results": {
            "date": "2019-03-23T20:00:00Z",
            "draw_id": 14,
            "draw_machine": "RNG2",
            "game_type": "DailyLotto",
            "total_pool_size": 892314.1,
            "total_sales": 1788483.0,
            "winning_numbers": [
                3,
                7,
                10,
                13,
                17
            ],
            "bonus_ball": null,
            "next_draw_date": "2019-03-24T20:00:00Z",
            "divisions": [
                {
                    "division": "DIV 1",
                    "winners": 3,
                    "winning_amount": 106116.7
                },
                {
                    "division": "DIV 2",
                    "winners": 380,
                    "winning_amount": 192.9
                },
                {
                    "division": "DIV 3",
                    "winners": 8828,
                    "winning_amount": 16.6
                },
                {
                    "division": "DIV 4",
                    "winners": 76982,
                    "winning_amount": 4.6
                }
            ]
        },
        "lotto_results": {
            "date": "2019-03-23T20:00:00Z",
            "draw_id": 1903,
            "draw_machine": "RNG2",
            "game_type": "Lotto",
            "total_pool_size": 38779613.51,
            "total_sales": 15264250.0,
            "winning_numbers": [
                34,
                40,
                33,
                2,
                38,
                46
            ],
            "bonus_ball": 21,
            "next_draw_date": "2019-03-27T20:00:00Z",
            "divisions": [
                {
                    "division": "DIV 1",
                    "winners": 0,
                    "winning_amount": 0.0
                },
                {
                    "division": "DIV 2",
                    "winners": 1,
                    "winning_amount": 99612.2
                },
                {
                    "division": "DIV 3",
                    "winners": 26,
                    "winning_amount": 6663.0
                },
                {
                    "division": "DIV 4",
                    "winners": 82,
                    "winning_amount": 2640.9
                },
                {
                    "division": "DIV 5",
                    "winners": 1784,
                    "winning_amount": 203.9
                },
                {
                    "division": "DIV 6",
                    "winners": 2765,
                    "winning_amount": 114.4
                },
                {
                    "division": "DIV 7",
                    "winners": 38275,
                    "winning_amount": 50.0
                },
                {
                    "division": "DIV 8",
                    "winners": 31210,
                    "winning_amount": 20.0
                }
            ]
        },
        "lotto_plus1_results": {
            "date": "2019-03-23T20:00:00Z",
            "draw_id": 1903,
            "draw_machine": "RNG2",
            "game_type": "Lotto Plus 1",
            "total_pool_size": 8547419.0,
            "total_sales": 6796672.5,
            "winning_numbers": [
                24,
                50,
                38,
                52,
                40,
                16
            ],
            "bonus_ball": 28,
            "next_draw_date": "2019-03-27T20:00:00Z",
            "divisions": [
                {
                    "division": "DIV 1",
                    "winners": 1,
                    "winning_amount": 6283008.9
                },
                {
                    "division": "DIV 2",
                    "winners": 0,
                    "winning_amount": 0.0
                },
                {
                    "division": "DIV 3",
                    "winners": 31,
                    "winning_amount": 5124.6
                },
                {
                    "division": "DIV 4",
                    "winners": 88,
                    "winning_amount": 2121.4
                },
                {
                    "division": "DIV 5",
                    "winners": 1751,
                    "winning_amount": 188.5
                },
                {
                    "division": "DIV 6",
                    "winners": 2354,
                    "winning_amount": 140.2
                },
                {
                    "division": "DIV 7",
                    "winners": 34728,
                    "winning_amount": 25.0
                },
                {
                    "division": "DIV 8",
                    "winners": 26038,
                    "winning_amount": 15.0
                }
            ]
        },
        "lotto_plus2_results": {
            "date": "2019-03-23T20:00:00Z",
            "draw_id": 1903,
            "draw_machine": "RNG2",
            "game_type": "Lotto Plus 2",
            "total_pool_size": 38779613.51,
            "total_sales": 15264250.0,
            "winning_numbers": [
                34,
                40,
                33,
                2,
                38,
                46
            ],
            "bonus_ball": 21,
            "next_draw_date": "2019-03-27T20:00:00Z",
            "divisions": [
                {
                    "division": "DIV 1",
                    "winners": 0,
                    "winning_amount": 0.0
                },
                {
                    "division": "DIV 2",
                    "winners": 1,
                    "winning_amount": 99612.2
                },
                {
                    "division": "DIV 3",
                    "winners": 26,
                    "winning_amount": 6663.0
                },
                {
                    "division": "DIV 4",
                    "winners": 82,
                    "winning_amount": 2640.9
                },
                {
                    "division": "DIV 5",
                    "winners": 1784,
                    "winning_amount": 203.9
                },
                {
                    "division": "DIV 6",
                    "winners": 2765,
                    "winning_amount": 114.4
                },
                {
                    "division": "DIV 7",
                    "winners": 38275,
                    "winning_amount": 50.0
                },
                {
                    "division": "DIV 8",
                    "winners": 31210,
                    "winning_amount": 20.0
                }
            ]
        }
    }
}