Cloud Fax and Notifications Account API 2.6 Documentation
GroupList
Cloud Fax and Notifications API Forums Home  
    prev  next        Table of Contents  GroupList  

15.2 GroupListRequest

GroupList Overview   GroupListResult

Tag Name
& type
#Description
GroupListRequest   Namespace of this element is http://ws.easylink.com/GroupList/2015/05
   SubmitId
xs:string
0-1Optional string identifying request, which will be echoed in result.
   CustomerAccountNumber
xs:unsignedInt
0-1Customer number of the EntityId provided. If this is omitted, the effective requester's customer is used.
   EntityId
EntityIdType
0-1The entity id for which group information is being requested. The value is either a group entity number, or a customer account number, depending on the type. If omitted, and the effective requester is a Fax2Mail administrator, then the administered group is used. If the effective requester is not a Fax2Mail administrator, then the requester's customer is used.
   @type
EntityLevel
1Entity type. Legal values are:
  • group
  • customer
("user" is not accepted for this purpose)
   IncludeUsers
xs:boolean
0-1Boolean value indicating whether users will be included in the result. The default is "false", which means only groups will be included.
   MaxDescendLevel
xs:unsignedInt
0-1The number of sub-levels that should be returned in the result. The default is to return the entire hierarchy.
   UniqueMembers
xs:boolean
0-1Boolean value specifying whether only one ChildEntity element will be returned for each unique EntityId value.

The default is "false", which means that if the result includes users, an F2M user EntityId may appear multiple times until each assigned faxNumber and emailAddress value appears in a GroupExtensions/Segment/Property. For most accounts, there is no more than one of either value for a user, but where there are multiple values the result may become awkwardly large, since each ChildEntity will have only one faxNumber and emailAddress along with all of the Aliases.

Setting UniqueMembers to true causes each EntityId value only to appear only once. The set of phone numbers and email addresses associated with each user can be determined by looking for INBOUND_FAX and INTERNET values in the Aliases segment of the returned GroupExtensions. The emailAddress and faxNumber Property elements will be omitted from the result, and other Property elements will only appear if they have a non-empty value.
   GroupListExtensions
ExtensionType
0-1This may be used to request additional group list features. See ExtensionType. No extension values are currently defined.
 
    prev  next        Table of Contents  GroupList  
© Copyright 2020 OpenText Corp. All Rights Reserved.
Privacy Policy | Cookie Policy
This information is subject to change. Please check frequently for updates.
Modified October 06, 2020