get_event_seat_history

Reads only.

Use this for the full history of one reserved seat. Use get_event_seats_live instead for every seat open now, and get_event_seats_recent for seats that moved in the last minutes. What happened to one reserved seat at one event, newest first. Name the seat by section, row and seat (as printed on a ticket, e.g. section "104", row "6", seat "2"), or by place_index when you already have one. Read changes: kind listed is the seat becoming available for sale (first true means it had not been listed in anything held for it), repriced is a re-listing at a different price and carries previous_price, unavailable is a period it was not for sale, from at to until_at, after which it was again, and gone is the seat leaving and not coming back, which is taken or pulled, the log does not say which. A seat that came back is never called gone. ONE unavailable ROW CAN STAND FOR MANY: times says how many periods it folds and away_seconds how long each one was, which is a stretch of three or more at one price, each within 10 percent of the middle one of that stretch; a period that does not fit ends the stretch and keeps its own row. Some seats leave the open set and come back on a fixed period, at one price, hundreds of times over days. Report the count and the typical length, never a list of departures, and never say a hold happened: the log does not say why the seat was away. On a folded row at and until_at span the whole run, including the times the seat was on sale between the periods. Pages join end to end through next_cursor, and gone is only ever on the first page. events is every crossing of the open set behind those changes; a re-listing is one close and one open about a second apart, so a seat that never moved off one price still carries dozens of them. price_exact false means the nearest known price. available false means the event has no live seat data at all; an empty timeline for an available event means the seat has not changed in the window. History depth is capped by plan like the price charts. 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