Developers Information - API & Web Services
API Method /user_list_events
This method lists the events created by this user. Only public events are returned if no authentication is passed.
Arguments
- authentication
- This method controls access via optional user authentication.
- user string
- The user email. Defaults to the authenticated user if not provided. (optional)
Example Request
https://www.eventbrite.com/xml/user_list_events?...&user=abc@test.com
Output Parameters
This method returns XML with the following structure:
- events array
- Array of events with the following structure:
- id integer
- The event ID.
- title string
- The event title.
- description string
- The event description.
- category string
- The event category.
- tags string
- The event tags/keywords.
- start_date string
- The event start date and time, in ISO 8601 format (e.g., "2007-12-31 23:59:59").
- end_date string
- The event end date and time, in ISO 8601 format (e.g., "2007-12-31 23:59:59").
- timezone string
- The event timezone, as listed in the Olson timezones database (e.g. "America/New_York").
- created string
- The date and time the event was created, in ISO 8601 format (e.g., "2007-12-31 23:59:59").
- modified string
- The date and time the event was last modified, in ISO 8601 format (e.g., "2007-12-31 23:59:59").
- privacy integer
- 0 for a private event, 1 for a public event.
- password string
- Reserved for private event only.
- capacity integer
- The total event capacity.
- url string
- The event registration URL.
- logo string
- The event logo URL.
- logo_ssl string
- The event logo URL for secure applications.
- status string
- The event status ("draft", "live", "started", "ended", or "canceled").
- background_colorstring
- Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
- text_colorstring
- Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
- link_colorstring
- Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
- title_text_colorstring
- Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
- box_background_colorstring
- Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
- box_text_colorstring
- Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
- box_border_colorstring
- Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
- box_header_background_colorstring
- Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
- box_header_text_colorstring
- Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
- venue
- The event venue with the following structure:
- id integer
- The venue ID.
- name string
- The venue name.
- address string
- The venue address.
- address_2 string
- The venue address (continued).
- city string
- The venue city.
- region string
- The venue state/province/county depending on the country.
- postal_code string
- The venue postal code.
- country string
- The venue country name.
- country_code string
- The venue country code, in 2-letter ISO 3166 format (e.g., "US").
- Lat-Long string
- The venue GeoLocation in WGS84 (Latitude/Longitude).
- organizer
- The event organizer with the following structure:
- id integer
- The organizer ID.
- name string
- The organizer name.
- description string
- The organizer description.
- url string
- The organizer URL.
- tickets array
- Array of ticket types available for this event with the following structure:
- id integer
- The ticket ID.
- name string
- The ticket name.
- description string
- The ticket description.
- type integer
- 0 for fixed-price tickets, 1 for donations.
- currency string
- The ticket currency, in 3-letter ISO 4217 format (e.g., "USD").
- price float
- The ticket price (not provided if the ticket is a donation).
- start_date integer
- The date and time when ticket sales start, in ISO 8601 format (e.g., "2007-12-31 23:59:59").
- end_date integer
- The date and time when ticket sales stop, in ISO 8601 format (e.g., "2007-12-31 23:59:59").
- quantity_available integer
- Number of tickets for sale (requires authentication).
- quantity_sold integer
- Number of tickets sold (requires authentication).
- visible boolean
- Flag indicating if the ticket is visible on the event registration page.
Example XML 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>1</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> <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>
Error Codes
This method may return these errors in an error document:
- 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.