Passlees bronze

Search events

Search published events by free-text query, category, city, and/or the dates they run on. Returns event summaries (id, name, city, venue, starting price). An event with coming_soon is announced but not on sale yet (coming_soon_when says roughly when): it has no tickets to buy. Omit every arg to browse everything.

• Find jazz concerts
• What sports events are on sale?
• Concerts in Guadalajara next weekend

Get event detail

Get one event with its sessions (dates) and ticket types (prices). A ticket type with a section is seated (pick a seat via check_availability); one with ga_capacity is general admission (buy by quantity). The price is what it costs today; regular_price and special_until, when present, say it is a limited-time special price and what it goes back to. A ticket type with requires is an add-on (e.g. camping): it can only be ordered together with the listed ticket types, at most one per such ticket in the same order. A ticket type with choose_day is for one day of a session that spans several (the session's days): each ga selection of it must say valid_on, one of those days, and the ticket gets in on that day only — ask the buyer which day.

• Show me the details and prices for this event

Check seat availability

List the seat map for a session (reserved seating). Only seats with status "available" can be bought. General-admission availability is confirmed at create_order time.

Create order

Reserve seats and/or general-admission tickets and create an unpaid order. Provide seats (each {ticket_type_id, seat_id}) and/or ga (each {ticket_type_id, quantity}) — at least one. Returns order_id, total, expires_at, and a guest_access_token you MUST keep to check status and fetch tickets. Then call start_payment.

• Buy 2 general admission tickets
• Reserve seat A12 for me

Start payment

Create a payment intent for an order and return a hosted checkout_url the buyer opens in a browser to pay. If mock_confirm is true (dev sandbox), settle instead with confirm_payment_sandbox.

Get order status

Check whether an order has been paid. Poll this after start_payment until paid is true, then call get_tickets.

Get tickets

Fetch the issued tickets (with QR codes) for a paid order. Returns an empty list until the order is paid and tickets are issued.

Confirm payment (sandbox)

DEV/SANDBOX ONLY: settle a payment through the mock provider (stands in for a provider webhook). Fails when a real payment provider is configured — then use the checkout_url from start_payment instead.