Zimbra REST API Reference:Get Item

Revision as of 15:46, 19 January 2010 by Sposetti (talk | contribs) (Parameters)

<< Back to Zimbra REST API Reference

REST API Method: Get Item

Gets an item.

URL

http://localhost:7070/home/john.doe/?id={item-id}&{params}

HTTP Method

GET

Item Id

  • id={item-id}. Required. Specifies the item id to retrieve.

Formats

Type Formats Default Format Comments
Mail Message json,xml,rss,atom,zip,tar,tgz,sync Defaults to MIME (RFC822). When using the zip,tar,tgz formats, the mail message is packaged in the archive as a .eml file (i.e. plain text in MIME RFC822 format).
Appointment json,xml,ics Defaults to iCalendar format(.ics).  
Contact json,xml,vcf Defaults to vCard format (.vcf).  
Task json,xml,ics,rss,atom Defaults to iCalendar format(.ics).  

See Response Formats for more information.

Requires Authentication

true (Go to Authentication)

Parameters

  • id. Required. The message id.
  • fmt. Optional. The response format.

Mail Message Parameters

  • imap_id. Optional. Specify an IMAP id in lieu of a message id.
  • part. Optional. Specify which part of the MIME message to retrieve.

Usage Examples

Download the contacts as a CSV file:

http://localhost:7070/home/john.doe/contacts
http://localhost:7070/home/john.doe/contacts?fmt=csv

Retrieve the contacts in XML format:

http://localhost:7070/home/john.doe/contacts?fmt=xml

Retrieve the contacts in JSON format:

http://localhost:7070/home/john.doe/contacts?fmt=json

Download the contacts as a ZIP file:

http://localhost:7070/home/john.doe/contacts?fmt=zip


Verified Against: Zimbra Collaboration Suite 6.0 Date Created: 01/16/2010
Article ID: https://wiki.zimbra.com/index.php?title=Zimbra_REST_API_Reference:Get_Item Date Modified: 2010-01-19



Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »


Jump to: navigation, search