Sign in

v1

latestOpenAPI 3.1.02026-08-0621022.3 KB

Retrieve current lottery draw information

Returns the active/current lottery draw information.

This is the first step required before purchasing a lottery ticket.

The response includes:

  • Current draw number and date
  • Pricing information (base price, rematch, second rematch) in cents
  • Sales period (begin_sales, end_sales) in HH:MM:SS format
  • Board limits (minimum_number_of_boards, maximum_number_of_boards)

Implementation Notes:

  • Use the draw_number from the response in the purchase request
  • Validate combination_count against minimum_number_of_boards and maximum_number_of_boards
  • Use pricing information to calculate total_amount for purchase
  • All prices are in cents (e.g., 1500 = $15.00 MXN)
get/api/v1/lottery_tickets/new

Query parameters

payee_idstring uuid required
Example:550e8400-e29b-41d4-a716-446655440000

Unique identifier of the lottery service (it will be provided by Monato). Must be a valid UUID v4 format.

Response

Current lottery draw successfully retrieved

draw_datestring

Date of the lottery draw in DD/MM/YYYY format

draw_numberstring

Draw number identifier

base_priceinteger

Base minimum price for a standard bet in cents (e.g., 1500 = $15.00 MXN)

min_priceinteger

Minimum price allowed by the provider

max_priceinteger

Maximum price allowed by the provider

rematchinteger

Additional base price for rematch option per bet in cents (e.g., 1000 = $10.00 MXN per bet)

second_rematchinteger

Additional base price for second rematch option per bet in cents (e.g., 500 = $5.00 MXN per bet). Requires rematch to be enabled.

begin_salesstring

Start time of the sales period for the draw in HH:MM:SS format (24-hour format)

end_salesstring

End time of the sales period for the draw in HH:MM:SS format (24-hour format)

minimum_number_of_boardsinteger

Minimum number of boards/combinations allowed by the provider. Used to validate combination_count in purchase request.

maximum_number_of_boardsinteger

Maximum number of boards/combinations allowed by the provider. Used to validate combination_count in purchase request.

Example response

{
  "draw_date": "13/01/2026",
  "draw_number": "7327",
  "base_price": 1500,
  "min_price": 1500,
  "max_price": 3780000,
  "rematch": 1000,
  "second_rematch": 500,
  "begin_sales": "08:00:00",
  "end_sales": "23:59:59",
  "minimum_number_of_boards": 1,
  "maximum_number_of_boards": 6
}