get_event_sections_live

Reads only.

Use this for open seats and prices per section right now. Use get_event_sections instead for daily prices per book, get_event_sections_at for a past moment, and get_event_section_series for one section over time. How many reserved seats are open for sale RIGHT NOW in each section of one event, with the lowest, median and highest price of those open seats. This is the live state of the house, not a daily rollup: use get_event_sections for what a section cost yesterday, and this for what is open in it this minute. Sections are keyed by the ticket code printed on a ticket (e.g. "104"), the same key get_event_sections uses, so the two line up. available false means the event has no live seat data at all, which is not an error and not a claim that the house is empty. capacity is how many seats the section holds in total and percent_taken is capacity minus the open seats as a percentage of capacity, so a seat a buyer took, one held back and one withdrawn all count the same: never report it as a count of sales. Both are null, never 0, for an event whose seat map states no capacity. Whenever the plan withholds a reading, its fields are absent rather than null and the top level withheld list names them: each entry has fields, entitled false, required_tier (the plan that unlocks them) and a one line message. An absent field named in withheld is a plan limit, never missing data. is_general_admission marks a section whose capacity is a declared allocation rather than a count of seats, and base_section names the section a row of accessible seats belongs to. General admission sections carry a count and one price. Pass all_in true to add min_all_in_price, the lowest price a buyer pays after fees among the section's open seats, which can be a different seat than min_price, and all_in_estimated, true when that price's fees were worked out from the event's other prices rather than stated, so say it is an estimate. Both are null when no open seat of the section has one, and both are absent unless asked for. sold_or_pulled says how many listings and tickets left the resale book in the last 24 hours and 7 days and what they were last asking, weighted by tickets, as both an average and a middle. Read the middle when the two disagree: a block parked at a placeholder price moves an average and not a middle. A listing leaves the book because a buyer took it or because its seller withdrew it, and nothing here tells those apart: do not report it as a count of sales, and the average is an asking price, not a price anyone paid. It is null, never 0, for an event whose resale book we do not hold at listing level, which is most events. The top level sold_or_pulled splits the event total by book and never sums them, and its sections list is complete where the sections array is only the sections with a seat still open and is capped by limit. What left the book is null only for an event with no held book; for an account whose plan does not include it, sold_or_pulled is absent and named in withheld. It is the primary price source, served on the plans that carry that source; any other caller gets a plan_required error with entitled false and required_tier naming the plan that unlocks it, never available false.

Parameters