Get Ticket

Retrieves detailed information about a specific ticket by its UUID, including all jugadas, commission snapshots, sorteo details, and print configuration.

Authentication

Requires authentication. Available to roles: VENDEDOR, VENTANA, ADMIN.

Path Parameters

string

required

UUID of the ticket to retrieve.

Response Fields

string

Ticket UUID.

ticketNumber

string

Unique ticket number in format TYYMMDD-XXXXXX-CC (e.g., T260303-00042A-15).

totalAmount

number

Total amount of all jugadas.

status

string

Ticket status. Possible values:

ACTIVE: Ticket is active and valid
CANCELLED: Ticket was cancelled
EVALUATED: Sorteo completed, winners determined
PAID: Winner ticket fully paid
EXCLUDED: Excluded from reports

isActive

boolean

Whether the ticket is active.

isWinner

boolean

Whether the ticket has any winning jugadas.

loteriaId

string

UUID of the lottery.

sorteoId

string

UUID of the sorteo.

ventanaId

string

UUID of the ventana.

vendedorId

string

UUID of the vendedor who created the ticket.

clienteNombre

string

Customer name.

createdAt

string

ISO 8601 timestamp of ticket creation.

updatedAt

string

ISO 8601 timestamp of last update.

businessDate

string

Business date in Costa Rica timezone when ticket was created.

totalCommission

number

Total commission amount (sum of all jugada commissions).

totalPayout

number

Total payout amount for winning tickets. Null for non-winning tickets.

totalPaid

number

Total amount paid out so far (for winning tickets).

remainingAmount

number

Remaining payout amount for partially paid winners.

lastPaymentAt

string

ISO 8601 timestamp of last payment (for winners).

paymentMethod

string

Method of last payment: cash, transfer, check.

paymentNotes

string

Notes from the last payment.

paymentHistory

array

Complete history of payments for this ticket.

Show Payment History Entry

string

Payment UUID.

amountPaid

number

Amount paid in this payment.

paidAt

string

ISO 8601 timestamp of payment.

paidById

string

UUID of user who made the payment.

paidByName

string

Name of user who made the payment.

method

string

Payment method: cash, transfer, check.

notes

string

Payment notes.

isFinal

boolean

Whether this partial payment was marked as final.

isReversed

boolean

Whether this payment was reversed.

reversedAt

string

ISO 8601 timestamp of reversal.

reversedBy

string

UUID of user who reversed the payment.

createdBy

string

UUID of the user who created the ticket (may differ from vendedorId if created via impersonation).

createdByRole

string

Role of the user who created the ticket: VENDEDOR, VENTANA, ADMIN.

isSorteoClosed

boolean

Whether the associated sorteo has been closed.

jugadas

array

Array of jugadas (bets) in this ticket.

Show Jugada Object

string

Jugada UUID.

ticketId

string

Reference to parent ticket UUID.

number

string

The lottery number bet on.

amount

number

Bet amount.

type

string

Bet type: NUMERO or REVENTADO.

reventadoNumber

string

Target number for REVENTADO bets. Null for NUMERO bets.

multiplierId

string

UUID of applied multiplier. Null if base multiplier used.

finalMultiplierX

number

Snapshot of multiplier value at ticket creation time.

isWinner

boolean

Whether this jugada won (number matched sorteo result).

payout

number

Payout amount for winning jugadas. Null for non-winners.

commissionPercent

number

Snapshot: Commission percentage applied (e.g., 5.5 for 5.5%).

commissionAmount

number

Snapshot: Calculated commission amount in colones.

commissionOrigin

string

Snapshot: Source of commission policy (user, ventana, banca, listero).

commissionRuleId

string

Snapshot: UUID of commission rule that applied.

listeroCommissionAmount

number

Snapshot: Commission amount for listero (ventana-level user).

isExcluded

boolean

Whether this jugada was excluded from reports.

excludedAt

string

ISO 8601 timestamp of exclusion.

excludedBy

string

UUID of user who excluded the jugada.

excludedReason

string

Reason for exclusion.

isActive

boolean

Whether the jugada is active.

createdAt

string

ISO 8601 timestamp of creation.

multiplier

object

Details of the applied multiplier (if any).

loteria

object

Lottery details.

Show Loteria Object

string

Lottery UUID.

name

string

Lottery name (e.g., “TICA”, “NACIONAL”).

rulesJson

object

Lottery rules configuration.

sorteo

object

Sorteo details with formatted name.

Show Sorteo Object

string

Sorteo UUID.

name

string

Formatted sorteo name with time (e.g., “TICA 7:00 PM”).

scheduledAt

string

ISO 8601 timestamp of scheduled draw time.

status

string

Sorteo status: SCHEDULED, EVALUATING, EVALUATED, CLOSED.

winningNumber

string

Winning number if sorteo has been evaluated.

hasWinner

boolean

Whether any tickets won in this sorteo.

digits

number

Number of digits (2 for Tiempos, 3 for Monazos).

vendedor

object

Vendedor information with print configuration.

Show Vendedor Object

string

Vendedor UUID.

name

string

Vendedor name.

printName

string

Name to print on tickets.

printPhone

string

Phone to print on tickets.

printWidth

number

Print width configuration (e.g., 48 for 48mm).

printFooter

string

Custom footer text for printed tickets.

printBarcode

boolean

Whether to print barcode.

printBluetoothMacAddress

string

Bluetooth MAC address for printer pairing.

ventana

object

Ventana information with print configuration (same structure as vendedor).

Example Request

curl -X GET "https://api.example.com/api/v1/tickets/623e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_TOKEN"

Example Response

{
  "success": true,
  "data": {
    "id": "623e4567-e89b-12d3-a456-426614174000",
    "ticketNumber": "T260303-00042A-15",
    "totalAmount": 1700,
    "status": "ACTIVE",
    "isActive": true,
    "isWinner": false,
    "loteriaId": "123e4567-e89b-12d3-a456-426614174000",
    "sorteoId": "223e4567-e89b-12d3-a456-426614174000",
    "ventanaId": "323e4567-e89b-12d3-a456-426614174000",
    "vendedorId": "423e4567-e89b-12d3-a456-426614174000",
    "clienteNombre": "Juan Pérez",
    "createdAt": "2026-03-03T14:30:00.000Z",
    "updatedAt": "2026-03-03T14:30:00.000Z",
    "businessDate": "2026-03-03",
    "totalCommission": 93.5,
    "totalPayout": null,
    "totalPaid": 0,
    "remainingAmount": 0,
    "lastPaymentAt": null,
    "paymentMethod": null,
    "paymentNotes": null,
    "paymentHistory": [],
    "createdBy": "423e4567-e89b-12d3-a456-426614174000",
    "createdByRole": "VENDEDOR",
    "isSorteoClosed": false,
    "jugadas": [
      {
        "id": "723e4567-e89b-12d3-a456-426614174000",
        "ticketId": "623e4567-e89b-12d3-a456-426614174000",
        "number": "05",
        "amount": 1000,
        "type": "NUMERO",
        "reventadoNumber": null,
        "multiplierId": "523e4567-e89b-12d3-a456-426614174000",
        "finalMultiplierX": 75,
        "isWinner": false,
        "payout": null,
        "commissionPercent": 5.5,
        "commissionAmount": 55,
        "commissionOrigin": "user",
        "commissionRuleId": "823e4567-e89b-12d3-a456-426614174000",
        "listeroCommissionAmount": 10,
        "isExcluded": false,
        "excludedAt": null,
        "excludedBy": null,
        "excludedReason": null,
        "isActive": true,
        "createdAt": "2026-03-03T14:30:00.000Z",
        "multiplier": {
          "id": "523e4567-e89b-12d3-a456-426614174000",
          "name": "Multiplicador Especial",
          "multiplierX": 75
        }
      },
      {
        "id": "823e4567-e89b-12d3-a456-426614174001",
        "ticketId": "623e4567-e89b-12d3-a456-426614174000",
        "number": "12",
        "amount": 500,
        "type": "NUMERO",
        "reventadoNumber": null,
        "multiplierId": null,
        "finalMultiplierX": 70,
        "isWinner": false,
        "payout": null,
        "commissionPercent": 5.5,
        "commissionAmount": 27.5,
        "commissionOrigin": "user",
        "commissionRuleId": "823e4567-e89b-12d3-a456-426614174000",
        "listeroCommissionAmount": 5,
        "isExcluded": false,
        "isActive": true,
        "createdAt": "2026-03-03T14:30:00.000Z",
        "multiplier": null
      },
      {
        "id": "823e4567-e89b-12d3-a456-426614174002",
        "number": "05",
        "amount": 200,
        "type": "REVENTADO",
        "reventadoNumber": "05",
        "multiplierId": null,
        "finalMultiplierX": 75,
        "isWinner": false,
        "payout": null,
        "commissionPercent": 5.5,
        "commissionAmount": 11,
        "commissionOrigin": "user",
        "commissionRuleId": "823e4567-e89b-12d3-a456-426614174000",
        "listeroCommissionAmount": 2,
        "isExcluded": false,
        "isActive": true,
        "createdAt": "2026-03-03T14:30:00.000Z"
      }
    ],
    "loteria": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "TICA",
      "rulesJson": {
        "minBet": 100,
        "maxBet": 10000,
        "digits": 2
      }
    },
    "sorteo": {
      "id": "223e4567-e89b-12d3-a456-426614174000",
      "name": "TICA 7:00 PM",
      "scheduledAt": "2026-03-03T19:00:00.000Z",
      "status": "SCHEDULED",
      "winningNumber": null,
      "hasWinner": false,
      "digits": 2
    },
    "vendedor": {
      "id": "423e4567-e89b-12d3-a456-426614174000",
      "name": "Carlos Rodríguez",
      "printName": "Vendedor #1",
      "printPhone": "+506 8888-8888",
      "printWidth": 48,
      "printFooter": "Gracias por su compra",
      "printBarcode": true,
      "printBluetoothMacAddress": "00:11:22:33:44:55"
    },
    "ventana": {
      "id": "323e4567-e89b-12d3-a456-426614174000",
      "name": "Ventana Central",
      "printName": "Ventana Central",
      "printPhone": "+506 2222-2222",
      "printWidth": 48,
      "printFooter": null,
      "printBarcode": true
    }
  }
}

Error Responses

404 Not Found

{
  "success": false,
  "error": "NOT_FOUND",
  "message": "Ticket no encontrado"
}

500 Internal Server Error - Invalid Sorteo

{
  "success": false,
  "error": "INTERNAL_ERROR",
  "message": "El ticket no tiene un sorteo asociado válido"
}

Notes

The sorteo name is formatted with scheduled time (e.g., “TICA 7:00 PM”)
Print configuration is extracted from vendedor and ventana settings JSON field
Commission snapshots are immutable and show the commission rates at ticket creation time
The finalMultiplierX shows the multiplier value at the time the ticket was created
No RBAC filtering is applied on single ticket retrieval (any authenticated user can view any ticket)
Payment history shows the complete audit trail of all payments and reversals

Authentication

Tickets

Sorteos (Draws)

Loterias

Bancas & Ventanas

Users & Vendedores

Commissions

Restrictions & Rules

Multipliers

Payments

Analytics & Reports

Accounts

Activity & Audit

Authentication

Path Parameters

Response Fields

Example Request

Example Response

Error Responses

404 Not Found

500 Internal Server Error - Invalid Sorteo

Notes

Build docs developers (and LLMs) love

Authentication

Tickets

Sorteos (Draws)

Loterias

Bancas & Ventanas

Users & Vendedores

Commissions

Restrictions & Rules

Multipliers

Payments

Analytics & Reports

Accounts

Activity & Audit

​Authentication

​Path Parameters

​Response Fields

​Example Request

​Example Response

​Error Responses

​404 Not Found

​500 Internal Server Error - Invalid Sorteo

​Notes

Build docs developers (and LLMs) love

Authentication

Path Parameters

Response Fields

Example Request

Example Response

Error Responses

404 Not Found

500 Internal Server Error - Invalid Sorteo

Notes