TicketUserServices

<back to all web services

SalesOverviewRequest

Requires Authentication
Requires any of the roles:Admin, TeamAdminRequired permission:Sales.Total
The following routes are available for this service:
POST/sales/overview
SalesOverviewRequest Parameters:
NameParameterData TypeRequiredDescription
EventOwnerIdbodyintNo
AdditionalOwnerIdsbodyint[]No
EventIdbodyint?No
FromUtcbodyDateTimeNo
ToUtcbodyDateTimeNo
CompareFromUtcbodyDateTime?No
CompareToUtcbodyDateTime?No
BucketbodystringNo
TopEventsLimitbodyintNo
RecentOrdersLimitbodyintNo
SalesOverviewResult Parameters:
NameParameterData TypeRequiredDescription
CurrentformSalesKpisNo
PreviousformSalesKpisNo
DeltaformSalesDeltasNo
TrendformList<SalesTrendBucket>No
PreviousTrendformList<SalesTrendBucket>No
TopEventsformList<SalesTopEvent>No
RecentOrdersformList<SalesRecentOrder>No
ByHourOfDayformList<SalesHourBucket>No
ByDayOfWeekformList<SalesDowBucket>No
TopProductsformList<SalesProduct>No
HasAnyDataEverformboolNo
OwnersformList<int>No
BucketformstringNo
FreshnessUtcformDateTimeNo
StatusCodeformintNo
MessageformstringNo
SalesKpis Parameters:
NameParameterData TypeRequiredDescription
GrossNetformdecimalNo
RefundedformdecimalNo
TicketsAllRealformintNo
TicketsPaidformintNo
OrdersformintNo
AovformdecimalNo
SalesDeltas Parameters:
NameParameterData TypeRequiredDescription
GrossNetformKpiDeltaNo
RefundedformKpiDeltaNo
TicketsAllRealformKpiDeltaNo
TicketsPaidformKpiDeltaNo
OrdersformKpiDeltaNo
AovformKpiDeltaNo
KpiDelta Parameters:
NameParameterData TypeRequiredDescription
AbsformdecimalNo
Pctformdouble?No
DirformstringNo
SalesTrendBucket Parameters:
NameParameterData TypeRequiredDescription
BucketformDateTimeNo
RevenueformdecimalNo
TicketsformintNo
SalesTopEvent Parameters:
NameParameterData TypeRequiredDescription
EventIdformintNo
EventNameformstringNo
EventDateformDateTime?No
GrossNetformdecimalNo
PaidTicketsformintNo
RealTicketsformintNo
OrdersformintNo
SalesRecentOrder Parameters:
NameParameterData TypeRequiredDescription
TicketIdformintNo
CreatedAtformDateTimeNo
EventNameformstringNo
AmountformdecimalNo
TicketCountformintNo
BuyerNameformstringNo
SalesHourBucket Parameters:
NameParameterData TypeRequiredDescription
HourformintNo
RevenueformdecimalNo
OrdersformintNo
TicketsformintNo
SalesDowBucket Parameters:
NameParameterData TypeRequiredDescription
DowformintNo
RevenueformdecimalNo
OrdersformintNo
TicketsformintNo
SalesProduct Parameters:
NameParameterData TypeRequiredDescription
TicketNameformstringNo
TicketsformintNo
RevenueformdecimalNo
OrdersformintNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /sales/overview HTTP/1.1 
Host: stubbur-app.azurewebsites.net 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	eventOwnerId: 0,
	additionalOwnerIds: 
	[
		0
	],
	eventId: 0,
	fromUtc: 0001-01-01,
	toUtc: 0001-01-01,
	compareFromUtc: 0001-01-01,
	compareToUtc: 0001-01-01,
	bucket: String,
	topEventsLimit: 0,
	recentOrdersLimit: 0
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	current: 
	{
		grossNet: 0,
		refunded: 0,
		ticketsAllReal: 0,
		ticketsPaid: 0,
		orders: 0,
		aov: 0
	},
	previous: 
	{
		grossNet: 0,
		refunded: 0,
		ticketsAllReal: 0,
		ticketsPaid: 0,
		orders: 0,
		aov: 0
	},
	delta: 
	{
		grossNet: 
		{
			abs: 0,
			pct: 0,
			dir: String
		},
		refunded: 
		{
			abs: 0,
			pct: 0,
			dir: String
		},
		ticketsAllReal: 
		{
			abs: 0,
			pct: 0,
			dir: String
		},
		ticketsPaid: 
		{
			abs: 0,
			pct: 0,
			dir: String
		},
		orders: 
		{
			abs: 0,
			pct: 0,
			dir: String
		},
		aov: 
		{
			abs: 0,
			pct: 0,
			dir: String
		}
	},
	trend: 
	[
		{
			bucket: 0001-01-01,
			revenue: 0,
			tickets: 0
		}
	],
	previousTrend: 
	[
		{
			bucket: 0001-01-01,
			revenue: 0,
			tickets: 0
		}
	],
	topEvents: 
	[
		{
			eventId: 0,
			eventName: String,
			eventDate: 0001-01-01,
			grossNet: 0,
			paidTickets: 0,
			realTickets: 0,
			orders: 0
		}
	],
	recentOrders: 
	[
		{
			ticketId: 0,
			createdAt: 0001-01-01,
			eventName: String,
			amount: 0,
			ticketCount: 0,
			buyerName: String
		}
	],
	byHourOfDay: 
	[
		{
			hour: 0,
			revenue: 0,
			orders: 0,
			tickets: 0
		}
	],
	byDayOfWeek: 
	[
		{
			dow: 0,
			revenue: 0,
			orders: 0,
			tickets: 0
		}
	],
	topProducts: 
	[
		{
			ticketName: String,
			tickets: 0,
			revenue: 0,
			orders: 0
		}
	],
	hasAnyDataEver: False,
	owners: 
	[
		0
	],
	bucket: String,
	freshnessUtc: 0001-01-01,
	statusCode: 0,
	message: String
}