# Ticketdesk marketplace snapshot format

Open **resale-dashboard.html** in a browser. Import ticket requests first, then select an event and seat request in the queue. Enter the event's approved alternate sections and row labels under **Approved sections and rows**. The default sort ranks eligible offers by the absolute difference from the request price. Offers whose fee status prevents an all-in comparison appear after comparable offers.

## Marketplace adapter contract

The six adapters expose an asynchronous search method. This initial version reads local snapshots and reports disconnected feeds as **Unavailable**. An authorized marketplace integration should verify the specific performance, venue, currency, available purchase quantities, and link destination before normalizing data. A network or access failure should produce an unavailable or error result. A successful snapshot with no eligible offers produces **No snapshot matches** for the selected request.

Use one JSON object per marketplace and performance.

| Field | Required value |
| --- | --- |
| marketplace | Ticketmaster, Vivid Seats, StubHub, TickPick, SeatGeek, or Gametime |
| checkedAt | ISO 8601 observation timestamp with offset or Z. Snapshots age out after 30 minutes. |
| eventVerified | true, attested by the reader after verifying the performance |
| event.name | Event name as mapped to the request |
| event.venue | Venue name as mapped to the request |
| event.localDate | Venue-local calendar date, YYYY-MM-DD |
| event.localTime | Venue-local kickoff time, HH:mm in 24-hour format |
| currency | USD |
| listings | Array of observed resale listings. Empty is valid for a completed search. |
| listings[].id | Marketplace listing ID, unique within the snapshot |
| listings[].section, listings[].row | Published seat labels |
| listings[].purchaseQuantities | Array of quantities the marketplace allows for this offer. Derive this from purchase rules. A listing with four seats may only be purchasable as a set of four. |
| listings[].pricePerTicket | USD number for the purchase option. If price varies by quantity, provide separately keyed offers for each price and quantity combination. |
| listings[].fees | included, excluded, or unknown. Use included only when the price reflects mandatory fees. |
| listings[].directListingUrl | Optional HTTPS URL to the specific listing. A marketplace home or event page belongs outside this field. |
| listings[].directLinkVerified | Optional reader attestation that the link resolves to the specific listing. The dashboard additionally checks the marketplace domain. |

Snapshot verification is performed by the source reader. The dashboard validates the data contract and matches it against the request. Marketplace links may expire. Allowed purchase quantities alone do not establish seat adjacency.

Ticketdesk's earlier search used explicit map-checked same, mirror, and better rules. This dashboard retains that approach and requires exact row labels. The purchase quantity must be offered explicitly. All-in total is calculated for the requested quantity when mandatory fees are included.
