Tag Name & type | # | Description |
---|
GroupListRequest | | Namespace of this element is http://ws.easylink.com/GroupList/2015/05 |
| SubmitId xs:string | 0-1 | Optional string identifying request, which will be echoed in result. |
| CustomerAccountNumber xs:unsignedInt | 0-1 | Customer number of the EntityId provided. If this is omitted, the effective requester's customer is used. |
| EntityId EntityIdType | 0-1 | The 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 | 1 | Entity type. Legal values are:
("user" is not accepted for this purpose) |
| IncludeUsers xs:boolean | 0-1 | Boolean 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-1 | The number of sub-levels that should be returned in the result. The default is to return the entire hierarchy. |
| UniqueMembers xs:boolean | 0-1 | Boolean 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-1 | This may be used to request additional group list features. See ExtensionType.
No extension values are currently defined. |