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_numberin the purchase. It must match the current active draw. - Validate
combination_countagainstminimum_number_of_boardsandmaximum_number_of_boards. - Calculate
total_amountfrom the prices. See Buy a ticket. - Only sell tickets between
begin_salesandend_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 |