Sales and Attendee Reports

Learn to generate sales and attendee reports using Eventbrite API.

We'll cover the following

Eventbrite API provides the facility to generate reports. It allows generating two types of reports: sales activity and attendees for an event.

Sales report

We can generate the report of our sales for an event. The following URL uses the GET method to generate the report:

https://www.eventbriteapi.com/v3/organizations/{organization_id}/reports/sales/?event_ids={event_id}

Request parameters

The request parameters required for this API call are as follows:

Object

Type

Category

Description

event_ids

array[string]

required

This object provides the  IDs of the events whose sales reports are required.

event_status

string

optional

This object provides the  status of the event. The possible values are: all, live, and ended.

start_date

string

optional

This object provides the start date of the event.

end_date

string

optional

This object provides the end date of the event.

filter_by 

string

required

It is a filter, and we can include more than one filter.

group_by

string

optional

This object groups the return data by specified variable. The possible values are payment_method, payment_method_application,

ticket,ticket_application,currency, event_currency,

reserved_section, event, event_ticket, event_application, country, city, state, source, zone, location, access_level, device_name, sales_channel_lvl_1, sales_channel_lvl_2, sales_channel_lvl_3, and delivery_method. 

period

number

optional

This object provides the time period in units of the selected date_facet.

date_facet

string

optional

This object provides the date period. The possible values are fifteen, hour, day, event_day, week, month, year, and none. The day is the default choice.

timezone

string

optional

This object provides the time zone of the event. If unspecified, by default, the value is the time zone of the first event.

Response parameters

The object array in the output JSON response has the following important parameters:

Object

Type

Description

timezone

string

This object provides the event’s time zone.

event_ids

array[string]

This object provides a list of IDs for public events.

data.date

string

This object provides the date of the event when it happens.

data.topic

string

This object provides the topic related to the event.

data.date_localized

string

This is the local start time of the event.

data.totals.currency

string

This object is the ISO 4217 3-letter currency.

data.totals.gross

number

This is the  final price of the ticket.

data.totals.net

number

The price of the ticket with any other charges.

data.totals.quantity

number

This is the quantity of the tickets.

data.totals.fees

number

This object provides the total amount of fees.

data.totals.royalty

number

This object provides the total amount of royalty.

Let’s run an example to retrieve the sale report of an event. Click “Run” to execute the code.

Press + to interact
import requests
import json
url = 'https://www.eventbriteapi.com/v3/organizations/{{ORGANIZATION_ID}}/reports/sales/?event_ids={{EVENT_ID}}'
headers = {
  'Authorization': 'Bearer {{PRIVATE_TOKEN}}'
}
response = requests.request("GET", url, headers=headers).json()
print(json.dumps(response, indent=4))

Attendee report

We can generate the report of our attendees for an event. The following URL uses the GET method to generate the report:

https://www.eventbriteapi.com/v3/organizations/{ORGANIZATION_ID}/reports/attendees/?event_ids={EVENT_ID}

Request parameters

The request parameters are the same as for the sales report.

Response parameters

The object array in the output JSON response has the following important attributes:

Object

Type

Description

timezone

string

This object provides the event’s time zone.

event_ids

array[string]

This object generates a list of public events ids.

data.date

string

This object provides the date of the event when it happens.

data.topic

string

This object provides the  topic related to the event.

data.date_localized

string

This is the local start time of the event.

data.totals.num_attendees

number

This object provides the total number of attendees.

data.totals.num_orders

number

This object provides the total number of orders.

Press + to interact
import requests
import json
url = 'https://www.eventbriteapi.com/v3/organizations/{{ORGANIZATION_ID}}/reports/attendees/?event_ids={{EVENT_ID}}'
headers = {
  'Authorization': 'Bearer {{PRIVATE_TOKEN}}'
}
response = requests.request("GET", url, headers=headers).json()
print(json.dumps(response, indent=4))