Get sales data

Returns sales records for a single event - each row is a real sale transaction. Rows are ordered by timestamp descending, then by id descending within a source (a stable tiebreak for paging). Under source=all, two sales sharing a timestamp are ordered sh first, then by that source's id tiebreak.

The v1 equivalent of GET /v0.3/salesdata/get. Same data, same billing - plus cursor pagination, a JSON response envelope, a listing_id on every row, and structured JSON errors. Responses are application/json, and v1 never forces gzip the way v0.3 does - any compression is ordinary content negotiation your HTTP client handles for you. See the migration guide.

Sources

Sales are observed on more than one marketplace. The optional source query parameter selects which rows you receive.

Every row carries a source field naming the marketplace it was observed on. The two sources do not carry the same keys, so read source to tell which shape a row has:

Sales whose seat details could not be determined are not returned by these endpoints, and are not counted in total_count. On vs rows, sales are observed from listing changes between pulls, so the per-event count is a lower bound.

Joining the two sources

norm_zone and norm_section exist so a vs row can be matched to the sh rows for the same seats. They hold the zone and section names used for those seats in sh sales for that event or venue, derived by matching rather than reported by the marketplace, and are "" when no match is found. sh rows carry neither field - their names are the naming space being translated into, so there is nothing to translate.

To join, compare a vs row's norm_section against a sh row's section, and its norm_zone against zone:

primary   = [r for r in rows if r["source"] == "sh"]secondary = [r for r in rows if r["source"] == "vs"]for sale in secondary:    same_seats = [        r for r in primary        if r["section"] == sale["norm_section"]        and r["zone"] == sale["norm_zone"]    ]

Compare listing_id as a string if you compare it at all - it is an integer on sh rows and a string on vs rows.

A source value outside the three above returns 400 invalid_param with param set to source. That response is free - it is rejected before any billing or data read.

Quantity and price

sh sales often reach us unenriched, without a quantity or price. For those we derive both from the listing data we hold for that listing; a quantity of 0 means it could not be reliably determined. vs sales carry both as reported.

Billing rules

Fetching an event's full history through pagination costs the same single pull as one GET /v0.3/salesdata/get call. The source value does not change what a page costs.

Pagination

Cursor-based. The first page response includes total_count; subsequent paginated pages omit it. next_cursor is opaque - pass it back verbatim via starting_after; don't parse it. Cursors are scoped to the event and the source they were issued under, and expire after 1 hour. Replaying a cursor with a different source returns 400 invalid_cursor. Use one source value for every page of a walk.

Example: fetching every page

Each response returns at most limit rows. To fetch an event's full sales history, keep requesting with starting_after=<next_cursor> until next_cursor is null:

API_KEY="YOUR_API_KEY"BASE="https://seatdata.io/api/v1/events/12345/sales"URL="$BASE?limit=200"while [ -n "$URL" ]; do  PAGE=$(curl -s "$URL" -H "Authorization: Bearer $API_KEY")  echo "$PAGE" | jq -c '.data[]' >> sales.jsonl  CURSOR=$(echo "$PAGE" | jq -r '.next_cursor // empty')  URL=${CURSOR:+"$BASE?starting_after=$CURSOR"}donewc -l sales.jsonl

Example: multi-source response

GET /api/v1/events/12345/sales?source=all&limit=2 returns one row from each marketplace, merged newest-first. Note the differing key sets - the second row carries the normalized fields, the first does not:

{  "event_id": 12345,  "data": [    {"timestamp": 1789489812, "quantity": 2, "price": 145.0, "zone": "Lower Level",     "section": "112", "row": "12", "listing_id": 4871203955, "source": "sh",     "all_in_price": null},    {"timestamp": 1789489140, "quantity": 2, "price": 139.0, "zone": "",     "section": "Lower Level 112", "row": "14", "listing_id": "8815520431",     "source": "vs", "all_in_price": 171.5,     "norm_zone": "Lower Level", "norm_section": "112"}  ],  "has_more": true,  "next_cursor": "opaque-token-string",  "total_count": 42,  "sources": [    {"source": "sh", "collecting_since": "2026-01-15", "tracked_for_event": true, "status": "ok"},    {"source": "vs", "collecting_since": "2026-08-30", "tracked_for_event": true, "status": "ok"}  ]}

Path Parameters

Query Parameters

Response Body