Retrieve user properties
Added by IBM contributorAnna G O'Neal | Edited by Claudia R Elbourn on June 26, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Retrieve a set of properties for individual users based on their email addresses.

Table 1. API details

Method Resource address
PROPFIND PROPFIND /calendar/r/dav/users/<user_email>, where <user_email> is the email address of the user.

The following code provides a sample implementation of the API. For details about using the API in your own development environment, see the Internet Engineering Task Force (IETF) Request for Comments (RFC) resources at the end of this topic.

Sample request


PROPFIND https://mail-usw.lotuslive.com/calendar/r/dav/users/bgs_demo07%40try.lotuslive.com/ HTTP/1.1

Host: mail-usw .lotuslive.com

User-Agent: iOS/5.0.1 (9A405) dataaccessd/1.0

Content-Length: 823

Accept: */*

Depth: 0

Accept-Encoding: gzip, deflate

Content-Type: text/xml

Accept-Language: en-us

Cookie: JSESSIONID=E7FF02CA6E863EB61A2B9CC53F4E861A

Authorization: Basic <base64 encoding of user_email:password>

Connection: keep-alive

Proxy-Connection: keep-alive



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

<A:propfind xmlns:A="DAV:">

<A:prop>

<B:allow ed-calendar-component-set xmlns:B="http://calendarserver.org/ns/"/>

<C:calendar-home-set xmlns:C="urn:ietf:params:xml:ns:caldav"/>

<C:calendar-user-address-set xmlns:C="urn:ietf:params:xml:ns:caldav"/>

<A:current-user-principal/>

<A:displayname/>

<B:dropbox-home-URL xmlns:B="http://calendarserver.org/ns/"/>

<B:email-address-set xmlns:B="http://calendarserver.org/ns/"/>

<B:notification-URL xmlns:B="http://calendarserver.org/ns/"/>

<A:principal-collection-set/>

<A:principal-URL/>

<A:resource-id/>

<C:schedule-inbox-URL xmlns:C="urn:ietf:params:xml:ns:caldav"/>

<C:schedule-outbox-URL xmlns:C="urn:ietf:params:xml:ns:caldav"/>

<A:supported-report-set/>

</A:prop>

</A:propfind>


Sample response


HTTP/1.1 207 Multi-Status

Server: nginx

Content-Type: application/xml;charset=utf-8

Cache-Control: private, max-age=0

Expires: Thu May 03 07:03:54 GMT 2012

DAV: 1, access-control, calendar-access, calendar-schedule, calendar-proxy, calendar-auto-schedule

Date: Thu, 03 May 2012 07:03:54 GMT

Content-Length: 2428

Connection: close

Set-Cookie: JSESSIONID=E2B63EB056350BBFA7068692766ACD32; Path=/calendar

Set-Cookie: JSESSIONID=E2B63EB056350BBFA7068692766ACD32; Path=/calendar; Secure



<D:multistatus xmlns:CS="http://calendarserver.org/ns/" xmlns:C="urn:ietf:params:xml:ns:caldav" xmlns:D="DAV:">

<D:response>

<D:href>/calendar/r/dav/users/bgs_demo07@try.lotuslive.com/</D:href>

<D:propstat>

<D:prop>

<D:displayname>bgs_demo07@try.lotuslive.com</D:displayname>

<CS:dropbox-home-URL xmlns:ns4="http://apple.com/ns/ical/">/calendar/r/dav/users/bgs_demo07@try.lotuslive.com/</CS:dropbox-home-URL>

<CS:notification-URL xmlns:ns4="http://apple.com/ns/ical/">/calendar/r/dav/users/bgs_demo07@try.lotuslive.com/</CS:notification-URL>

<C:calendar-home-set xmlns:ns4="http://apple.com/ns/ical/">

<D:href>/calendar/r/dav/calendar/bgs_demo07@try.lotuslive.com/</D:href>

</C:calendar-home-set>

<C:calendar-user-address-set xmlns:ns4="http://apple.com/ns/ical/">

<D:href>mailto:bgs_demo07@try.lotuslive.com</D:href>

</C:calendar-user-address-set>

<C:schedule-inbox-URL xmlns:ns4="http://apple.com/ns/ical/">

<D:href>/calendar/r/dav/calendar/bgs_demo07@try.lotuslive.com/inbox/</D:href>

</C:schedule-inbox-URL>

<C:schedule-outbox-URL xmlns:ns4="http://apple.com/ns/ical/">

<D:href>/calendar/r/dav/calendar/bgs_demo07@try.lotuslive.com/outbox/</D:href>

</C:schedule-outbox-URL>

<D:principal-collection-set xmlns:ns4="http://apple.com/ns/ical/">

<D:href>/calendar/r/dav/users/</D:href>

</D:principal-collection-set>

<D:principal-URL xmlns:ns4="http://apple.com/ns/ical/">

<D:href>/calendar/r/dav/users/bgs_demo07@try.lotuslive.com/</D:href>

</D:principal-URL>

</D:prop>

<D:status>HTTP/1.1 200 OK</D:status>

</D:propstat>

<D:propstat>

<D:prop>

<B:allow ed-calendar-component-set xmlns:A="DAV:" xmlns:B="http://calendarserver.org/ns/"/>

<A:current-user-principal xmlns:A="DAV:"/>

<B:email-address-set xmlns:A="DAV:" xmlns:B="http://calendarserver.org/ns/"/>

<A:resource-id xmlns:A="DAV:"/>

</D:prop>

<D:status>HTTP/1.1 404 Not Found</D:status>

</D:propstat>

</D:response>

</D:multistatus>

 

Related Resources

Web Distributed Authoring and Versioning (WebDAV) Access Control Protocol

Calendaring Extensions to WebDAV (CalDAV)