Get Section Seat Availability
get_event_sections_liveRead-only
Returns open-seat counts per section of one event from the primary market's seat data, now or in the past: every section now with prices and capacity, every section at a past moment, one section over time, general admission sections over time, or every section across a window. Use it when the person asks how many seats are open by section, or how availability changed. For section prices and resale listings use get_event_sections; for single seats use get_event_seats.
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_sections_live"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | The instant to read the house at, ISO 8601. Defaults to now. | |
| view | No | now (default): each section right now, with the lowest, median and highest price, capacity and what left the resale market. at: every section's open count at a past moment, up to 90 days back; read it twice and subtract to see where seats went. series: one section over up to 7 days, in 5m or 1h steps; only the newest point's prices are exact. ga: each general admission section's open count over time; added and removed are changes to the open count. frames: every section's open count at each step of a window; with source mlb, the club's primary market's seat frames, which its seat reads take as frame. | |
| 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 | now: sections returned when `sections` is omitted, default 60. ga: points per page, default 200. | |
| since | No | Oldest point to include, ISO 8601. Defaults to 24 hours ago. | |
| until | No | Newest step, ISO 8601. Defaults to now. | |
| width | No | Instead of pages: the shape of the whole history in one answer, as the first, last, lowest and highest point of each of `width` equal slices of time from the section's first observation to now. At most four points a slice. Use it for the shape of a busy section, which can hold tens of thousands of changes. | |
| all_in | No | Adds each section's lowest, median and highest price after fees (lowest_aip_price, median_aip_price, highest_aip_price) and whether the lowest is an estimate (aip_estimated). On by default; false returns the prices before fees alone. | |
| bucket | No | Point size: 5m for the last few hours, 1h for days. `open_count` is exact at every bucket. THE PRICES ARE NOT (source tm): they are exact on the newest bucket only; on every earlier bucket they are the seats open now valued at the prices recorded for that bucket, an approximation. Never present an earlier bucket's price as the price at that time. | |
| cursor | No | next_cursor from the previous page, for newer points. A page after the first carries the points alone. | |
| 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. | |
| section | No | series: the section's section_key, e.g. "104" (required). ga: a general admission section's code, to add its exact points. | |
| 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. | |
| interval | No | Step size. One too fine for the window is widened, never the window shortened; `interval` says which was served. | |
| sections | No | now and frames: only these sections, by section_key. Omit for the whole house. | |
| occurrence | No | 0 unless the event lists the code twice, as `sections` shows. `section` and `occurrence` together name one section. |