Events
Events are what Eventbrite is all about!
Be sure to attach a venue and a organizer profile object to each of your events in order to make them easier to find.
Public events that include a venue, an organizer profile, and which include tickets that are currently available for sale, will automatically be added to our search index, and will be available via our event_search method.
Accessing public event information does not require additional user-authentication tokens.
We do not allow event ticket sales to take place via our API, since that process may involve exposing customer payment information to 3rd party services. Instead, send your users to the appropriate event page, so that we can ensure that their transaction will be processed securely.
Related Methods
Object structure
| Name | description |
|---|---|
| id | The event ID. This should be stored as a numeric string or a long int. |
| title | The event title. (string) |
| description | The event description. (text/html) |
| category | The event category. |
| tags | The event tags/keywords. For SEO optimization, public events only. |
| start_date | The event start date and time, in ISO 8601 format (e.g., “2007-12-31 23:59:59″). |
| end_date | The event end date and time, in ISO 8601 format (e.g., “2007-12-31 23:59:59″). |
| timezone | The event timezone, usually returned as a GMT offset. The following information may be useful for converting the API response value to it’s Olson timezone equivalent. |
| created | The date and time the event was created, in ISO 8601 format (e.g., “2007-12-31 23:59:59″). |
| modified | The date and time the event was last modified, in ISO 8601 format (e.g., “2007-12-31 23:59:59″). |
| privacy | Private for a private event, Public for a public event. |
| password | Private event pages are only visible to those who know the related password. |
| capacity | The total event capacity. This attribute is used to limit sales based on a site’s maximum occupancy, the number of total seats available, or based on fire-safety regulation limitations. This count may be lower than the sum of all available tickets. When the event capacity is set to ’0′ (default), then sales will only be limited based on the per-ticket-type settings. |
| num_attendee_rows | The number of attendees that have registered for the event. Capacity minus num_attendee_rows equals the number of remaining available spaces at the selected event, except in cases where capacity is set to zero. |
| url | The event registration URL. |
| logo | The event logo URL. This field can only be set through our web interface. |
| logo_ssl | The event logo URL to use for SSL-encrypted connections. |
| status | The event status (“draft”, “live”, “started”, “ended”, or “canceled”). |
| background_color | Custom hexadecimal color for your registration page. Format: FFFFFF without the pound |
| text_color | Custom hexadecimal colors for your registration page. |
| link_color | Custom hexadecimal colors for your registration page. |
| title_text_color | Custom hexadecimal colors for your registration page. |
| box_background_color | Custom hexadecimal colors for your registration page. |
| box_text_color | Custom hexadecimal colors for your registration page. |
| box_border_color | Custom hexadecimal colors for your registration page. |
| box_header_background_color | Custom hexadecimal colors for your registration page. |
| box_header_text_color | Custom hexadecimal colors for your registration page. |
| venue | The event venue. For more information on the structure of this object, see our venues page. |
| organizer | The event’s “organizer profile” page. For more information about organizer profile pages, and their object structure, see our organizer profiles page. |
| tickets | The tickets entity will contain an array of the ticket types associated with this event. For more information on the structure of these objects, see our tickets page. |