Description
The Sales Summary API provides aggregated sales data for a specific event. This endpoint is particularly useful for getting an overview of sales performance metrics, including daily sales breakdowns.
Request
GET /events/{provider}/{eventId}/sales-summary
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/152386655/sales-summary?startDate=2023-12-13&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",
"salesData": [
{
"date": "2023-12-14",
"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:10.8653956Z"
}
}
Response Fields
| 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 Data Object (Array)
| Field | Type | Description |
|---|
| date | string | Date of sales (YYYY-MM-DD) |
| totalTickets | integer | 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 |
| 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 |
