API Documentation

• API Methods
• Authentication
• API Errors

API Method /organizer_list_events

This method lists the events created by this organizer. Only public events are returned if no authentication is passed.

Arguments

authentication

This method controls access via optional user authentication.

id string

The organizer id.

Example Request

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.

Organizer Error

No such organizer.

Organizer Error

This organizer does not belong to this user.

Not Found

No events found for this organizer.