Tools
get_event_seats
Reads reserved seats at one event: every seat open now, the seats that just moved, or one seat's full history.
When to use it
- You need seat-level detail: exactly which seats are open, and the price of each. Leave
viewout. - You want what just moved: seats that came off sale, came back or changed price in the last minutes.
viewrecent. - You want the story of one seat, every seat of a section, or every seat of the event that changed:
viewhistory, withscope. - It replaces
get_event_seats_live,get_event_seats_recentandget_event_seat_history, whose names still answer: see Old names.
Inputs
view(string):live(the default): the seats open now, or at a past moment withat.recent: the seats that moved in the last minutes.history: one seat's changes. One oflive,recent,history.event_id(string, required): The event, by its Ticker id (evplus ten characters), assearch_eventsand the other tools return it.at(date-time): Withlive, read the seats open at this past moment, with a time zone. Leave it out for now. A past answer has no prices.limit(integer): The most rows to return.live: 200 seats when you leave it out, at most 5,000.recent: 50 seats.history: 50 changes per page, at most 200. A larger value reads as the most.all_in(boolean): Withlive, also each open seat's price after fees, and whether that price is an estimate, in the same order asopen. On when you leave it out;falsereturns the prices before fees alone. Not served withat.minutes(integer): Withrecent, how far back to look, in minutes, at most 120. From 1 to 120.section(string): The section printed on a ticket, like104. Withrecent, only this section. Withhistory, the seat's section together withrowandseat, or withscopesection, the section to read.row(string): Withhistory, the row printed on the ticket, like6.seat(string): Withhistory, the seat number printed on the ticket, like2.place_index(integer): Withhistory, the seat's place index fromliveorrecent, in place of section, row and seat.since(date-time): Withhistory, the oldest change to include, with a time zone. Leave it out to reach the seat's first change.cursor(string): Withhistory,next_cursorfrom the page before: one seat's older changes, or the next seats of a section or event read.scope(string): Withhistory:seat(the default) reads one seat.sectionreads every seat ofsectionthat changed sincesince.eventreads every seat of the event that changed. One ofseat,section,event.rows(boolean): Withhistoryandscopesectionorevent:truegives each seat's changes instead of the summary, up to 25 seats a page in seat order.
Examples
Which seats are open right now, and at what price?
{ "event_id": "ev3rp4z4zhq1" }What happened to section 104, row 6, seat 2?
{
"event_id": "ev3rp4z4zhq1",
"view": "history",
"section": "104",
"row": "6",
"seat": "2"
}Which seats at this event changed this week, section by section?
{
"event_id": "ev8k2m4q7x1a",
"view": "history",
"scope": "event",
"since": "2026-10-08T00:00:00Z"
}What comes back
live:open, the open seats as place indexes, with each seat's price at the same position inprices.countis the true total, so read it, not the list length;truncatedsayslimitcut the lists.recent: one row per seat, newest first, withplace_index,section,row,seat,kind(openon sale,closeoff sale),at,priceandchanges.republishtrueis a re-listing at a new price, not a sale.historyfor one seat:seat, thenchanges, newest first:listed,repriced(withprevious_price),unavailable(off sale fromattountil_at, then back) orgone(taken or pulled, and the history does not say which).next_cursorgets older changes.historywithscopesectionorevent: one summary per section, with the seats that changed, the seats off sale at the end of the window, and the first and last change. Withrowstrue: up to 25 seats a page in seat order, each with its changes; a seat with more than 50 rows saystruncatedand carries its ownnext_cursor, and the page'snext_cursorgets the next seats.availablefalsemeans Ticker has no live seat data for the event.
Limits and quota
- Reads only: it changes nothing.
- The Max plan and above include it.
- Reserved seats only. For general admission sections, use
get_event_sections_livewithviewga. - An input the view does not take, like
place_indexwithrecent, is refused by name.