Docs

Lottery · Guides

Get the active draw

Retrieve the current draw, its prices, sales period and board limits.

Always get the active draw before a purchase. It gives you the data you need to build a valid purchase request.

Request

Get the active draw
curl -X GET "https://dev-api.finco.lat/api/v1/lottery_tickets/new?payee_id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Query parameter Required Description
payee_id Yes Your lottery service identifier, provided by Monato. Must be a valid UUID v4.

See Retrieve current lottery draw information.

Response

200 OK
{
  "draw_number": "7327",
  "draw_date": "13/01/2026",
  "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
}
Field Type Description
draw_number string Draw number. Use it in the purchase request.
draw_date string Draw date, DD/MM/YYYY
base_price integer Base price for a standard bet, in cents. 1500 is $15.00 MXN.
min_price integer Minimum price allowed by the provider
max_price integer Maximum price allowed by the provider
rematch integer Additional price per bet for the rematch option, in cents
second_rematch integer Additional price per bet for the second rematch option, in cents. Requires rematch.
begin_sales string Start of the sales period, HH:MM:SS (24-hour)
end_sales string End of the sales period, HH:MM:SS (24-hour)
minimum_number_of_boards integer Minimum combination_count
maximum_number_of_boards integer Maximum combination_count, up to 6

Use the response

  • Send draw_number in the purchase. It must match the current active draw.
  • Validate combination_count against minimum_number_of_boards and maximum_number_of_boards.
  • Calculate total_amount from the prices. See Buy a ticket.
  • Only sell tickets between begin_sales and end_sales.

Errors

Status Body Cause
401 { "errors": ["Access denied"] } Invalid or expired token
422 { "error": "Invalid input" } Invalid input
422 { "error": "Company not found" } The company was not found