---
title: "Retrieve current lottery draw information"
method: GET
path: "/api/v1/lottery_tickets/new"
---

# Retrieve current lottery draw information

`GET /api/v1/lottery_tickets/new`

## Request

- Base URL: `https://dev-api.finco.lat`
- URL: `https://dev-api.finco.lat/api/v1/lottery_tickets/new`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/monato/apis/monato-s-lottery-api/docs/api/v1/lottery_tickets/new/get.ts> (a function with typed inputs; its response is checked against the schema)

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)

## Query parameters

- `payee_id` string, uuid, required

## Response `200`

Current lottery draw successfully retrieved

- LotteryDrawResponse
  - `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.

## Other responses

- `401`: Authentication failed
- `422`: Invalid input or company not found

---

[API](https://skmtc.dev/monato/apis/monato-s-lottery-api.md) - [All operations](https://skmtc.dev/monato/apis/monato-s-lottery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monato/apis/monato-s-lottery-api/revisions/87f479815236?raw)