API Method /venues/ical

This function returns an iCalendar (RFC-2445) (not XML) document of events occuring at a specified venue.

Arguments

authentication
This method controls access via authentication.
id string
The id of the venue to use as the feed source.
 
 

Example Request

Here's an example search URL:

http://api.eventful.com/rest/venues/ical?...&keywords=concert&location=san+diego

Output Parameters

Output from this function is an VCALENDAR block with the following constructs:
METHOD string
Always "PUBLISH". Required by iCal format.
CALSCALE string
Always "GREGORIAN". Required by iCal format.
PRODID string
Required by iCal format.
VERSION string
Required by iCal format.
X-WR-CALNAME string
The venue name.
VEVENT array
An array of VEVENT events. Each event entry has the following structure:
DTSTART string
The event start time, in ISO 8601 format (e.g. "20050301T190000").
DTEND string
The event end time, in ISO 8601 format (e.g. "20050301T190000").
DTSTAMP string
The last modified time, in ISO 8601 format (e.g. "20050301T190000").
SUMMARY string
The event title.
DESCRIPTION string
The event description.
LOCATION string
The venue name.
SEQUENCE integer
Always 0.
UID string
The unique ID for this event.
URL string
URL of associated event on Eventful site.

Example iCalendar Response (indented for clarity, actual response does not contain spaces.)

BEGIN:VCALENDAR
METHOD:PUBLISH
CALSCALE:GREGORIAN
PRODID:-//EVDB//www.evdb.com//EN
VERSION:2.0
X-WR-CALNAME:University of California\, San Diego (UCSD)
BEGIN:VEVENT DTSTART:20051113T140000
DTSTAMP:20051029T234505Z
SUMMARY:Free Sunday Afternoon Tours of UCSD @UCSD
DESCRIPTION:...
LOCATION:University of California\, San Diego (UCSD)
SEQUENCE:0
UID:E0-001-000437754-7
URL:http://eventful.com/E0-001-000437754-7
END:VEVENT ...
END:VCALENDAR

Error Codes

This method may return these errors in an error document:

Authentication error
The specified user was not found or provided invalid credentials.
Missing parameter
A mandatory parameter was not set.
Not found
There is no venue with that identifier.