Partner API | Shows On Sale

Description

The Sales Details API provides detailed transaction-level data for a specific event. This endpoint allows you to retrieve individual sale records within a specified date range.

Request

GET /events/{provider}/{eventId}/sales-details

Supported Providers

Currently, only stubhub is supported as a provider.

Parameters

Parameter	Type	Required	Description
provider	string	Yes	The ticket provider (currently only `stubhub`)
eventId	string	Yes	Unique identifier for the event

Query String Parameters

Parameter	Type	Required	Description
startDate	string	No	Start date for the date range (format: YYYY-MM-DD)
endDate	string	No	End date for the date range (format: YYYY-MM-DD)

Example Request

GET /events/stubhub/156376576/sales-details?startDate=2023-01-01&endDate=2024-12-15

Response

{
    "marketplaceId": "152386655",
    "marketplace": "StubHub",
    "name": "Foo Fighters",
    "venue": "Petco Park",
    "eventDate": "2024-08-07T17:30:00Z",
    "date": "2024-08-07T17:30:00+00:00",
    "city": "San Diego",
    "state": "California",
    "country": "USA",
    "minimumSalesDataDate": "2023-10-04T00:00:00Z",
    "maximumSalesDataDate": "2024-08-02T00:00:00Z",
    "salesDetails": [
        {
            "date": "2023-12-14",
            "soldTickets": [
                {
                    "sectionName": "207",
                    "row": "3",
                    "seats": "6 - 15",
                    "quantity": 2,
                    "price": 328.83,
                    "priceFormatted": "$328.83",
                    "soldDate": "2023-12-14T01:46:18.537Z"
                }
            ],
            "totalTickets": 27,
            "totalSales": 5917.66,
            "minSoldPrice": 73.91,
            "maxSoldPrice": 523.62,
            "avgSoldPrice": 219.17,
        }
    ],

    "_request": {
        "requestedStartDate": "2023-12-13T00:00:00",
        "requestedEndDate": "2024-12-15T00:00:00",
        "requestTimestamp": "2025-03-27T20:50:51.4717379Z"
    }
}

Response Fields

Event Information

Field	Type	Description
marketplaceId	string	Unique identifier for the event in the marketplace
marketplace	string	Name of the ticket marketplace
name	string	Event name
venue	string	Venue name
eventDate	string	ISO 8601 timestamp of the event
date	string	ISO 8601 timestamp with timezone
city	string	Event city
state	string	Event state/province
country	string	Event country
minimumSalesDataDate	string	ISO 8601 timestamp of the earliest available sales data
maximumSalesDataDate	string	ISO 8601 timestamp of the latest available sales data

Sales Details Object (Array)

Field	Type	Description
date	string	Date of sales (YYYY-MM-DD)
soldTickets	array	Array of individual ticket sales for this date
totalTickets	integer	Total number of tickets sold on this date
totalSales	number	Total revenue from sales on this date
minSoldPrice	number	Lowest ticket price sold on this date
maxSoldPrice	number	Highest ticket price sold on this date
avgSoldPrice	number	Average ticket price on this date
minimumSalesDataDate	string	ISO 8601 timestamp of the earliest available sales data for this date
maximumSalesDataDate	string	ISO 8601 timestamp of the latest available sales data for this date

Sold Ticket Object

Field	Type	Description
sectionName	string	Venue section identifier (e.g., "207", "Field A3", "Pit")
row	string	Row identifier (e.g., "3", "R12", "24")
seats	string	Seat numbers or range (e.g., "6 - 15", "7 - 8", "26 - 26")
quantity	integer	Number of tickets in this sale
price	number	Price per ticket
priceFormatted	string	Formatted price with currency symbol (e.g., "$328.83")
soldDate	string	ISO 8601 timestamp of the sale

Request Information

Field	Type	Description
requestedStartDate	string	The start date requested in the query parameters
requestedEndDate	string	The end date requested in the query parameters
requestTimestamp	string	ISO 8601 timestamp of when the request was processed

Error Responses

Status Code	Description
400	Invalid request parameters
404	Event not found
401	Unauthorized
403	Forbidden