List Orders and Attendees

Learn how to list the orders of different categories and attendees using the API call.

We'll cover the following

Eventbrite API provides the facility to retrieve orders and attendees of an event within an organization. The order details are considered confidential and are kept private. Only the organization owner or the member can retrieve this information, and the order owner can see all details.

Retrieve all orders of a specific event

To retrieve the list of all orders in an event, we will use the following URL, which uses the GET method:

https://www.eventbriteapi.com/v3/events/{event_id}/orders

We will provide the {event_id} of the targeted event in the URL. It will return a paginated response with a list of all orders of the targeted event.

Press + to interact
import requests
import json
url = 'https://www.eventbriteapi.com/v3/events/{{EVENT_ID}}/orders/'
headers = {
	'Authorization': 'Bearer {{PRIVATE_TOKEN}}',
	'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers).json()
print(json.dumps(response, indent=4))

Filter orders

We can use the above URL to append the specific parameters and to retrieve the filtered orders. For example, if we want to retrieve orders by a specific email address, we can use the following URL:

https://www.eventbriteapi.com/v3/events/{event_id}/orders/?only_emails={email_address}

Filter parameters

We can use the parameters below to filter the orders.

Field

Type

Description

status

string

This object filters event orders by status. The possible values are active, inactive,

both, and all_not_deleted.

changed_since

datetime

This object changes orders on or after this time.

only_emails

array[string]

This string places the orders by the email address.

exclude_emails

array[string]

This exclude orders by the email address in the return object.

refund_request_statuses

array[string]

This string returns the orders related to specific order status.. The possible values are completed,  pending,  outside_policy,  disputed, and denied.

Below is an example to retrieve the information of an order for a specific email address. Specify the email address in the URL in line 4 and run the code.

Press + to interact
import requests
import json
url = 'https://www.eventbriteapi.com/v3/events/{{EVENT_ID}}/orders/?only_emails=<email_address>'
headers = {
	'Authorization': 'Bearer {{PRIVATE_TOKEN}}',
	'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers).json()
print(json.dumps(response, indent=4))

List a specific order

Now that we’ve retrieved all the orders in the widget above, we have to retrieve the details of a specific order. We’ll provide a specific order_id in the URL. We can use the following URL to fetch the details of a specific order, and it uses the GET method:

https://www.eventbriteapi.com/v3/orders/{order_id}/

It will return the JSON object of the order. We can retrieve the {order_id} in the code widget above and paste it into the code widget below to run it.

Press + to interact
import requests
import json
url = 'https://www.eventbriteapi.com/v3/orders/{{ORDER_ID}}/'
headers = {
	'Authorization': 'Bearer {{PRIVATE_TOKEN}}',
	'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers).json()
print(json.dumps(response, indent=4))

Retrieve attendees by event

We use the event_id to retrieve the attendees of an event. The following URL uses the GET method to retrieve the attendees:

https://www.eventbriteapi.com/v3/events/{event_id}/attendees/
Press + to interact
import requests
import json
url = 'https://www.eventbriteapi.com/v3/events/{{EVENT_ID}}/attendees'
headers = {
	'Authorization': 'Bearer {{PRIVATE_TOKEN}}',
	'Content-Type': 'application/json'
}
response = requests.request("Get", url, headers=headers).json()
print(json.dumps(response, indent=4))