Service: zimbraAccount

Command: GetAccountDistributionLists
Namespace: urn:zimbraAccount
Description: Returns groups the user is either a member or an owner of.
Notes: For example, if isOwner="1" and isMember="none" on the request, and user is an owner and a member of a group, the returned entry for the group will have isOwner="1", but isMember will not be present.
Properties:
Authorization token required true
Admin Authorization token required false

GetAccountDistributionListsRequest

    <GetAccountDistributionListsRequest [ownerOf="{owner-of} (0|1)"] [memberOf="{member-of} (all | directOnly | none)"]
                                           [attrs="{attrs}"] /> ## GetAccountDistributionListsRequest

elements and attributes you can define within a <GetAccountDistributionListsRequest> element:

XPath Required / Optional Description
@ownerOf Optional (0 or 1) Type: 0|1
Set to 1 if the response should include groups the user is an owner of.
Set to 0 (default) if do not need to know which groups the user is an owner of.
@memberOf Optional (0 or 1) Type: all | directOnly | none
Possible values:
  1. all - need all groups the user is a direct or indirect member of.
  2. none - do not need groups the user is a member of.
  3. directOnly (default) - need groups the account is a direct member of.
@attrs Optional (0 or 1) Type: String
comma-seperated attributes to return. Note: non-owner user can see only certain attributes of a group. If a specified attribute is not visible to the user, it will not be returned.

GetAccountDistributionListsResponse

    <GetAccountDistributionListsResponse> ## GetAccountDistributionListsResponse
        (<dl ref="{dl-ldap-dn}" [d="{dl-display-name}"] [dynamic="{dl-is-dynamic} (0|1)"] [via="{via-dl-name}"]
                 [isOwner="{isOwner} (0|1)"] [isMember="{isMember} (0|1)"] name="{object-name}" id="{object-id}"> ## DLInfo
            (<a n="{key}">{value}</a> ## KeyValuePair)*
          </dl>)*
    </GetAccountDistributionListsResponse>

elements and attributes you can define within a <GetAccountDistributionListsResponse> element:

XPath Required / Optional Description
/dl Optional (0 or more) Information on distribution lists
/dl@ref Required (only 1) Type: String
ldap dn of the DL.
/dl@d Optional (0 or 1) Type: String
Display name of group
/dl@dynamic Optional (0 or 1) Type: 0|1
Flags whether the group is dynamic or not
/dl@via Optional (0 or 1) Type: String
{via-dl-name} = is present if the account is a member of the returned list because they are either a direct or indirect member of another list that is a member of the returned list. For example, if a user is a member of engineering@domain.com, and engineering@domain.com is a member of all@domain.com, then the following would be returned:
     <dl name="all@domain.com" ... via="engineering@domain.com"/>
 
/dl@isOwner Optional (0 or 1) Type: 0|1
Flags whether user is the owner of the group.
Only returned if ownerOf on the request is 1 (true)
/dl@isMember Optional (0 or 1) Type: 0|1
Flags whether user is a member of the group.
Only returned if memberOf on the request is 1 (true)
/dl@name Required (only 1) Type: String
Name
/dl@id Required (only 1) Type: String
ID
/dl/a Optional (0 or more) Type: {value}
Attributes
Description for element text content:Value
/dl/a@n Required (only 1) Type: String
Key