Do you sell tickets for an event, performance or venue?
Sell more tickets faster with Eventfinda. Find out more. Find out more about Eventfinda Ticketing.

Event Resource

Event

This resource represents an event.

Example

<?xml version="1.0"?>
<error>An error occurred</error>

Fields

Name Description Access*
address

The full address of the event.

All
artists

A collection of artists performing at the event. See the Artist resource description for more detail.

All
booking_phone

If available a phone number that can be called to book tickets to the event.

Full
booking_web_site

If available a URL and name of where tickets to this event can be booked.

Full
category

The category of the event. See the Category resource description.

All
datetime_end

The date and time that the event ends in format YYYY-mm-dd H:M:S. This is represented in the events local time. Also see the sessions element.

All
datetime_start

The date and time that the event starts in format YYYY-mm-dd H:M:S. This is represented in the events local time. Also see the sessions element.

All
datetime_summary

A textual summary of when the event is occurring. The format of this can be controlled using the
date_format default %a %e %b %Y
time_format default ''
date_time_separator default ''
start_end_separator default ' - '
parameters. The date_format and time_format parameters allow you to specify the format of the date and time using strftime formats. The separator parameters specify what characters to separate those parts with.

All
description

Event description. This is truncated to 220 characters unless using a full access account.

All*
id

Integer uniquely representing the event.

All
images

A collection of images (and their transforms) relating to the event. See the description of the Image resource for more detail.

All
is_free

Whether the event is marked as a free event.

All
is_featured

Eventfinda uses its editorial control to flag some events as featured. Featured events often get preferential treatment during display and ordering within lists.

All
is_cancelled

Whether the event is cancelled. See also the sessions element as it is also possible for some sessions to be cancelled.

All
location

The location of the event. See the Location resource description.

All
location_summary

A textual summary of the events location, usually a venue name followed by the city or town.

All
name

Name of the event.

All
point

Geolocation information for the event if available. This includes a lat (latitude) and a lng (longitude) element.

All
presented_by

Some events include a presented by message, e.g. "Presented by ACME Inc." or "Brought to you by the letter A". Events can be filtered by presented_by.

All
restrictions

Textual representation of any age restrictions on the event, e.g. R18, All Ages Licensed

All
sessions

A collection of sessions including an attribute with the number of sessions in the collection. See the session resource description below for more detail.

All
ticket_types

A collection of ticket_types. See the Ticket Types resource description for more detail.

All
timezone

The timezone of the events location.

All
username

The username of the user who listed the event.

All
url

Canonical and absolute URL for the event.

All
url_slug

Unique URL slug.

All
web_sites

A collection of web_sites relating to the event. Each web_site contains a url and name element.

All
video

Embedded video url.

All

*Account types with access to this field, see resource documentation for more information.

API Help & Support

For all API support enquiries please email support@eventfinda.co.nz.