Lottery Data API Documentation

Get Next Jackpot

This API allows you to retrieve the estimated jackpot amount in the next draw for the specified game.

Please note that the API key shown in the examples below is not valid. You must replace the API key value with your API key or please sign up for an API account if you do not have one.

Next Jackpot API Request

The base URL for our next jackpot API is:

https://www.magayo.com/api/jackpot.php

Request Parameters

Parameter

Description

Valid Values

api_key

Your assigned API key. This parameter is required.

Your assigned API key value.

game

The lottery game for which you would like to retrieve the next lottery jackpot amount. This parameter is required.

Please refer to the list of supported jackpots and values to use.

format

The API response format. This parameter is optional and the default format is JSON.

json or xml

Examples:

To retrieve the next jackpot for USA Powerball game in JSON format:

https://www.magayo.com/api/jackpot.php?api_key=hXJDjsp8I6RY&game=us_powerball

To retrieve the next jackpot for EuroMillions game in XML format:

https://www.magayo.com/api/jackpot.php?api_key=hXJDjsp8I6RY&game=euromillions&format=xml

View sample PHP snippets on how to use our lottery data APIs

Next Jackpot API Response

Element

Description

Value

error

Error code. Value greater than zero indicates an error.

The list of error codes are listed below.

next_draw

The date of the next lottery draw.

YYYY-MM-DD
Example: 2019-03-10

currency

The currency of the jackpot amount.

ISO 4217 3-letter currency code
Example: USD

jackpot

The next jackpot amount.
You can use the Is Fixed Jackpot API to check if the jackpot is rolling or fixed.

Numeric for games with rolling jackpot or string for games with fixed jackpot
Example: 80000000
Example: 1,000 a day for life

Example of response in JSON format:

{
"error" : 0,
"next_draw" : "2016-06-03",
"currency" : "USD",
"jackpot" : "80000000"
}

Example of response in XML format:

<response>
<error>0</error>
<next_draw>2016-06-03</next_draw>
<currency>EUR</currency>
<jackpot>80000000</jackpot>
</response>

List of Error Codes

Error Code

Description

Action or Resolution

0

No error.

Proceed to process the next lottery jackpot retrieved.

100

API key not provided.

Please add the api_key parameter in your API request.

101

Invalid API key.

Please check & correct the value of the api_key parameter in your API request.

102

API key not found.

Please check & correct the value of the api_key parameter in your API request.

200

Game not provided.

Please add the game parameter in your API request.

201

Invalid game.

Please check & correct the value of the game parameter in your API request.

202

Game not found.

Please check & correct the value of the game parameter in your API request.

300

Account suspended.

You have violated our terms of use.

303

API limit reached.

You may like to consider upgrading your API plan.

Jackpot Lottery Winner

Mexico Chispazo winning Jackpot lottery ticket

"I played the recommendation... and I won the first prize!"

magayo Lotto software user

See the winning lottery tickets of magayo Lotto users

Download magayo Lotto software

magayo Lotto is also available as an Android app

Easily integrate lottery data with our lottery API!

magayo.com is verified safe by Google Safe Browsing

magayo.com is verified safe by Norton Safe Web