Retrieve current lottery draw information

GET /api/v1/lottery_tickets/new

Try it ▸

Base URL https://dev-api.finco.lat · operationId getLotteryDraw

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)

Authorization

BearerAuth Bearer token

Bearer token authentication. Include the token in the Authorization header: Authorization: Bearer YOUR_ACCESS_TOKEN

Obtain your access token from Monato support team.

Query parameters

payee_id string (uuid) required

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

Example 550e8400-e29b-41d4-a716-446655440000

Responses

200 Current lottery draw successfully retrieved application/json

draw_date string

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

draw_number string

Draw number identifier

base_price integer

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

min_price integer

Minimum price allowed by the provider

max_price integer

Maximum price allowed by the provider

rematch integer

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

second_rematch integer

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_sales string

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

end_sales string

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

minimum_number_of_boards integer

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

maximum_number_of_boards integer

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

401 Authentication failed application/json

errors array of string required

Array of error messages

422 Invalid input or company not found application/json

error string required

Error message describing the validation failure

Invalid input Company not found

This request is in the Monato · Lottery Postman collection.Download collection

Request

curl -X GET "https://dev-api.finco.lat/api/v1/lottery_tickets/new?payee_id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://dev-api.finco.lat/api/v1/lottery_tickets/new?payee_id=550e8400-e29b-41d4-a716-446655440000", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${TOKEN}`,
  },
});
const data = await res.json();

import requests

res = requests.get(
    "https://dev-api.finco.lat/api/v1/lottery_tickets/new?payee_id=550e8400-e29b-41d4-a716-446655440000",
    headers={
        "Authorization": f"Bearer {TOKEN}",
    },
)
data = res.json()

Response

{
  "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
}

{
  "errors": [
    "Access denied"
  ]
}

{
  "error": "Invalid input"
}

{
  "error": "Company not found"
}