Get Individual Seats
get_event_seatsRead-only
Returns individual reserved seats at one event from the primary market's seat data: the seats open now or at a past moment, seats that just came on or off sale, one seat's history, or seats once for sale that are not now. Use it when the person asks about a specific seat or row, or the exact seats open in a section. For open-seat counts per section use get_event_sections_live; for section prices and resale listings use get_event_sections.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"event_id": "<event_id>"
},
"name": "get_event_seats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | Read the open seats as they stood at this instant, ISO 8601. Omit for now. | |
| row | No | Row, e.g. "6". | |
| days | No | How far back to read, in days. With since too, the later of the two. Omit to read back to the first change. | |
| rows | No | scope section or event: each seat's changes, up to 25 seats a page in seat order, instead of the summary. A seat with more than 50 rows is truncated and carries its own next_cursor for scope seat. | |
| seat | No | Seat number, e.g. "2". | |
| view | No | live (default): every seat open now, or at a past moment with at, as place indexes with prices and each seat's section, row and seat beside it; read count, not the list length, and next says when more seats are open than the answer lists. recent: seats that came on or off sale in the last minutes; republish marks a price change, not a sale. history: one seat's history, named by section, row and seat or by place_index; with scope section or event, every seat that changed, as a summary per section or, with rows true, each seat's history a page at a time. closed: the seats once for sale and not now. released: how many seats each opened sale window (each presale and the public on sale) released, a seat counted once in the window it first went on sale, by section, with the price range at release, and the event total. source mlb reads a club's primary market one frame at a time (list them with get_event_sections_live view frames). | |
| frame | No | source mlb only, and required for its seat reads: one of the event's frames, as get_event_sections_live view frames lists them. | |
| limit | No | Rows returned. live and closed: seats, default 200, at most 5000. recent: seats, default 50. history: changes per page, default 50, at most 200. | |
| scope | No | seat (default): one seat. section: every seat of `section` that changed since `since`. event: every seat of the event that changed. A section or event read answers a summary per section unless `rows` is true. source tm only. | |
| since | No | Oldest change to include, ISO 8601. Omit to reach the seat's first change. | |
| all_in | No | Adds each open seat's price after fees (aip_prices) and whether it is an estimate (aip_estimated), same position as `open`. On by default; false returns the prices before fees alone. Not served with `at`. | |
| cursor | No | next_cursor from the previous page: one seat's older changes, or the next seats of a section or event read. | |
| source | No | tm (the default) or mlb, a club's primary market. mlb reads one frame at a time: list them with get_event_sections_live view frames and source mlb. | |
| minutes | No | How far back to look. | |
| section | No | Section code, e.g. "104". live and recent: only this section. history: the seat's section, with row and seat. | |
| currency | No | usd or venue. venue answers an event in a Canadian or UK venue with every price in the venue's currency (CAD or GBP) at the event's Bank of Canada rate; one rate converts every market, so the cheapest market and any order stay the same. Omit for USD. A view with no price ignores it. An answer in the venue's currency says currency, venue_currency, fx_rate (USD per one unit of venue_currency) and fx_rate_date; quote the currency with every price and the rate date when it is CAD or GBP. A US event is always USD. mlb_* prices keep mlb_currency. | |
| event_id | Yes | The event to read. | |
| place_index | No | The seat's place index, instead of section, row and seat. |