Get Event Section Prices and Listings
get_event_sectionsRead-only
Returns market data per section: one event's prices and tickets now and over the last 7 days, its listings on sale, each section's level and neighbors, one series across chosen sections, or the section map as a picture. Use it when the person asks about prices or listings by section, or for an event's cheapest listings. Across a performer's shows or several events, view find answers a section, level, ticket count or price in ONE call: never one call per event. view prices (the default) puts the vs, tm_primary and tm_resale markets side by side by section_key, or reads one market with source. For open-seat counts per section use get_event_sections_live; for single seats use get_event_seats.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_event_sections"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| row | No | One row label, matched without case or surrounding spaces. | |
| view | No | find: across a performer's upcoming events or a list of events, the events with listings in a section or on a level, at least min_quantity tickets together, at or under max_price, all-in unless price_basis says otherwise; per section each market where a row exists, with its cheapest and median, and no_match says why an event has none. Takes performer_id or event_ids, not event_id. prices (default): each section's prices and tickets now and for the last 7 days; with source, one market under its own section names (mlb has current sections only); unavailable names a market whose listings could not be read right now. levels: each section's level, the sections close to it on that level and the section across from it, each with the source that answered (our seat map, the section's own names, or the section number); a level is never guessed. listings: the listings on sale, one per row with section_key, row, quantity, prices, the market's own deal score (0 to 10), its own seat quality numbers (svs on vs, seat_quality_score and star_rating on sh) and ticker_listing_id (Ticker's id for the listing, the same on every read), cheapest first; withheld names a source the plan leaves out, rows_truncated means more listings follow and next_cursor reads them. aggregate: one series across the sections asked (sections, required) on one listing source: lowest, quartiles, tickets and listings per read. map: the event's section map as a picture, each section colored by one market's lowest price or tickets (color_by), with each drawn section's number by section_key; drawn false means the event has no map to draw. | |
| level | No | Only this level. A number, 100 level, 100s or 100, is the sections numbered 100 to 199, on whatever the venue calls that deck, leaving out suites, boxes, lofts, the floor and pits. A word, lower or mezzanine, is a level that holds the word. An event with no such level comes back in no_match with reason no_such_level and the levels it has. | |
| limit | No | Rows returned. prices: sections when `sections` is omitted, default 40, at most 200. levels: sections, default 200, at most 1000. listings: listings, default 50, at most 100. find: events, default 25, at most 50. | |
| order | No | listings: price (the default) reads the cheapest first, by the price after fees and then before. section walks by source (vs, sh, sg, tmr, sgp, aq), then section, row and price. deal_score ranks one source with deal scores, highest first. | |
| range | No | prices and aggregate: how far back the series reaches, counted back from today: 3d, 7d (the default), 30d, 90d or all. | |
| cursor | No | listings: next_cursor from the previous page, with the same source, order and filters, for the next page. | |
| render | No | A rendered chart (a PNG image content block) is included ahead of the data by default. Pass render:false for a data-only (smaller) response. | |
| source | No | all (the default): vs, tm_primary and tm_resale side by side. A market code: that market alone, under its own section names. With view listings, all reads every listing source the plan includes, and vs, sh, sg, tmr, sgp or aq reads that one. With view aggregate, one of vs (the default), sh, sg, tmr, sgp or aq. With view find, all or one market, gt too. With view map, the market whose sections color the map: vs (the default), tmr, sh, sg, sgp, tm or aq. | |
| exclude | No | Comma separated. Listings to leave out of this answer: `zone` (Unassigned seats, the seller holds no specific seats yet; vs only) and `view` (Limited view, the market says the seats see the stage or field only in part; vs, sg, sgp and sh). Absent or empty: every listing counts, and the answer is the one with no exclude. A source that cannot state a kind is not filtered by it; `excluded` names what was left out. A price with nothing left is null, never 0. Set it only when the user asks to leave these listings out; the default answer is the whole market. | |
| parking | No | Parking passes listed inside the event are never among its tickets. hide (the default) leaves them out; include adds them as the parking group on the first page, at most 200; only lists the passes as the listings. On a parking event the passes are its listings at any value. Set it only when the user asks about parking. | |
| color_by | No | price (the default): each section's lowest price. tickets: the tickets on sale in it (on tm, the seats open). | |
| 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 | No | The event to read. | |
| quantity | No | Number of tickets to buy from one listing, or a list of up to 8 numbers (e.g. [2,4]) to keep a listing that sells any of them. Uses the stated splits when available and the listed quantity otherwise. | |
| sections | No | prices and listings: only these sections, by a market's own label or by section_key (e.g. ["108","FL2","FLOOR-10"]); omit for the whole house. aggregate: the sections to combine, required. find: only these sections at each event; GA or General Admission reaches every general admission section. | |
| event_ids | No | The events to read, at most 50, ours or a marketplace's. Name this or performer_id. | |
| max_price | No | At or under this price per ticket, in USD, on price_basis. | |
| granularity | No | `daily` (the default): one history point a date, its last reading. `intraday`: every reading the history holds, as the app reads it. | |
| price_basis | No | all_in (the default): what a buyer pays after fees. pre_fee: before fees. With max_price, a listing with no price on this basis does not match, and unpriced_on_basis counts it. | |
| min_quantity | No | At least this many tickets together in one listing, by the listing's quantity; its splits say what the seller allows. Default 1. | |
| performer_id | No | One performer: its 50 soonest upcoming events. Ticker performer id, `pf` plus ten characters. Name this or event_ids; event_ids wins when both come. | |
| include_history | No | Set false for current levels only. | |
| all_in_price_max_usd | No | Maximum all-in USD price per ticket, inclusive. | |
| all_in_price_min_usd | No | Minimum all-in USD price per ticket, inclusive. |