Overview

Tools

Technical Reference

Wise words

"Everything is theoretically impossible, until it is done. One could write a history of science in reverse by assembling the solemn pronouncements of highest authority about what could not be done and could never happen."

- Robert A. Heinlein

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.

Eventful API