API Method /users/calendars/list

Given a user ID, returns a list of that user's calendars.

Note: This method requires user authentication to list private calendars.

Arguments

authentication
This method requires the usual authentication arguments.
owner string
The Eventful username of the calendars' owner. (optional, defaults to authenticated user)

Example Request

Here's an example request URL:

http://api.eventful.com/rest/users/calendars/list?app_key=...&owner=eventor

Output Parameters

Output from this function is an XML block with the following constructs.
calendars
A list of calendars owned by the specified owner.
count integer
The number of calendars in this list.
calendar
Each calendar entry has the following structure:
id string
The calendar ID.
name string
The calendar title.
privacy boolean
The calendar's privacy level: public ("1"), private ("2"), or sharable ("3").

Example XML Response

<?xml version="1.0" encoding="UTF-8"?>

<calendars count="4">
  <calendar id="C0-001-000000778-3">
    <name>Birthdays</name>
    <privacy>1</privacy>
  </calendar>
  <calendar id="C0-001-000000779-2">
    <name>San Diego</name>
    <privacy>1</privacy>
  </calendar>
  <calendar id="C0-001-000001065-3">
    <name>Concerts</name>
    <privacy>1</privacy>
  </calendar>
  <calendar id="C0-001-000000977-2">
    <name>Mars Society</name>
    <privacy>2</privacy>
  </calendar>
</calendars>