<?xml version="1.0" encoding="UTF-8" ?>
<?xml-stylesheet type="text/xsl" href="../notes.xsl"?>
<Documentation>
  <Title code="0515">SubAccountGroupList</Title>
  <Overview>
    <p>
      Schema to report which of a user's sub-accounts have access to its address book groups, and
      what the respective access levels are.
    </p>
  </Overview>
  <Request schema="0515_RequestSubAccountGroupList.xsd">
    <p>
      The 'UserID' and 'Password' elements identify the account.
      The 'ServiceName' element must be set to 'SubAccountGroupList'.
      The 'SoftwareVersion' element is for internal 2SMS use only and should not be set.
      There should be an empty 'ServiceDetail' element.
    </p>
  </Request>
  <Response schema="0515_ResponseSubAccountGroupList.xsd">
    <p>
      This method returns a successful '00/OK' response if details on group access for the user's sub accounts
      were successfully retrieved. The 'Result' element details how many sub-account / group mappings were identified.
    </p>
    <p>
      The 'Detail' element contains a set of 'Mapping' children, which in turn contain the
      following child elements:
    </p>
    <ul>
      <li>The 'SubAccount' element identifies the sub-account to which the mapping refers.</li>
      <li>The 'GroupName' element identifies the mapped group by name.</li>
      <li>The 'GroupID' element identifies the mapped group by its 2SMS internal reference ID.</li>
      <li>
        The 'AccessLevel' element shows the access level for the specified group / sub-account combination.
        It will be one of the three values 'high', 'medium' or 'low'. For a comprehensive account of what different
        access levels allow see schema code <a href="./0140_documentation.xml">0140</a>.
      </li>
    </ul>
  </Response>
</Documentation>