Lottery Data API Documentation

Get Next Draw Date

This API allows you to retrieve the next draw date 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 Draw Date Request

The base URL for our next draw date API is:

https://www.magayo.com/api/next_draw.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 draw date. This parameter is required.

Please refer to the list of supported games 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 draw date for USA Powerball game in JSON format:

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

To retrieve the next draw date for EuroMillions game in XML format:

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

Next Draw Date 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

Example of response in JSON format:

{
"error" : 0,
"next_draw" : "2019-03-10"
}

Example of response in XML format:

<response>
<error>0</error>
<next_draw>2019-03-10</next_draw>
</response>

List of Error Codes

Error Code

Description

Action or Resolution

0

No error.

Proceed to process the next draw date 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