API Method user_list_events

This method lists the events created by the authenticated user. Public events may optionally be returned if no authentication tokens are submitted.

This method can return a lot of data! In order to speed up response times, try filtering our unnecessary event attributes by taking advantage of the ‘do_not_display’ parameter, or by selecting events by status.

Request Parameters

Name	description
user	Find public events by supplying a user’s email address. The default response will include public and private events from the authenticated user if any authentication tokens are supplied.
display	A comma-separated list of additional output fields to display. Available fields include: `custom_header,custom_footer,confirmation_page,confirmation_email`
do_not_display	Comma separated list without spaces. Valid options include: description,venue,logo,style,organizer,tickets Example: do_not_display=venue,logo,style Leaving this field blank will return all event details.
only_display	A comma-separated list of fields to display. If this parameter is present, the call will only return those fields. If this parameter is not present, other display parameters apply. This parameter overrides other display parameters. Available fields include: `id,title,description,start_date,end_date,timezone, url,capacity,created,modified,privacy,password,logo,status, venue,organizer,tickets`
event_statuses	Comma separated list without spaces. Valid options include: live, started, or ended Example: event_statuses=live,started If you leave this field blank, it will return everything. Also note that the “ended” option will only return events that have ended in the past 7 days.
asc_or_desc	Valid options include ‘asc’ or results in ascending order or ‘desc’ or descending order based on event start_date. Default: asc

Example Request URL

https://www.eventbrite.com/xml/user_list_events?...&user=abc@test.com

Example Response

<?xml version="1.0" encoding="utf-8" ?>
<events>
	<event>
		<id>908163459</id>
		<title>Best NYC New Year's Party</title>
		<description>Come spend New Year's Eve with us!</description>
		<start_date>2008-12-31 20:00:00</start_date>
		<end_date>2009-01-01 06:00:00</end_date>
		<timezone>US/Eastern</timezone>
		<url>http://dev-win.eventbrite.com/event/1003</url>
		<created>2007-11-03 12:47:06</created>
		<modified>2008-01-09 10:12:15</modified>
		<privacy>Public</privacy>
		<url>http://nycparty.eventbrite.com</url>
		<venue>
			<id>1</id>
			<name>Madison Square Garden</name>
			<address>4 Penn Plaza</address>
			<address_2></address_2>
			<city>New York</city>
			<region>NY</region>
			<postal_code>10001</postal_code>
			<country>United States</country>
			<country_code>US</country_code>
		</venue>
		<organizer>
			<id>65739440</id>
			<name>New Year's NYC Team</name>
			<description>We organizer the best parties in town!</description>
			<url>http://www.eventbrite.com/org/65739440</url>
		</organizer>
		<tickets>
			<ticket>
				<id>45264859</id>
				<name>VIP Registration</name>
				<description>Access to VIP Rooms</description>
				<type>0</type>
		    	        <max>0</max>
			        <min>0</min>
				<currency>USD</currency>
				<price>199.99</price>
				<start_date>2008-10-24 00:00:00</start_date>
				<end_date>2008-12-30 23:00:00</end_date>
				<quantity_available>100</quantity_available>
				<quantity_sold>0</quantity_sold>
			</ticket>
		</tickets>
	</event>
</events>

Method-Specific Errors

More information about error-handling and common error messages are available in our error docs.

error_type	error_message
Request Error	The API request was not properly formed.
Application Key Error	There is a problem with the application key provided.
Authentication Error	The specified user was not found or the login credentials didn’t match.
Not Found	No events found for this user.

Usage Notes

Authentication: required
Rate-limited: Yes
Output formats: JSON, XML

Related Methods