Skip to end of metadata
Go to start of metadata

Get a group


  • GET| (root)/group/{group_id}

The group_id can be a group name (cn) or a regid.



Content of the response contains one class "group". Other html is for browser formatting. More than one name can be returned.


  • An ACL identifier of "dc=all" (type="none") means everyone.
  • An ACL identifier of "dc=none" (type="none") means no one.
  • If email is enabled, the Contact field must be present and non-null.

    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
    <html xmlns="" xml:lang="en">
     <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=utf-8"/>
      <div class="group" version="version_no">
        Regid: <span class="regid">Group's regid</span>
        <span class="names">
         <span class="name">Group_name</span>
        Title: <span class="title">Group's title</span>
        Description: <span class="description">Group's description</span>
        Group contact: <span class="contact">contact id</span>
        Created: <span class="createtime">group create time</span>
        Modified: <span class="modifytime">group modify time</span>
        Membership modified: <span class="membermodifytime">membership modify time</span>
        <!-- version v2 and greater -->
           Authn factor: <span class="authnfactor">1|2</span>
           Classification: <span class="classification">u|p|r|c</span>
           Membership dependency group: <span class="dependson">dependency group cn</span>
           GID: <span class="gid">gid_value</span>
               <!-- end v2 -->
        <!-- The enabled flag is "UWExchange" or "disabled" -->
        Email Enabled: <span class="emailenabled">UWExchange</span>
        Published email address: <span class="publishemail">email_address</span>
        Allowed senders:
        <ul class="authorigs">
           <li class="authorig">sender id</li>
           <!-- More (li) if there are multiple allowed senders -->
        Report to originator: <span class="reporttoorig">0 or 1</span>
        <ul class="admins">
        <li class="admin" type="(type)">identifier</li>
         <!-- More (li) if the group has more admins -->
        Allowed updaters:
        <ul class="updaters">
        <li class="updater" type="(type)">identifier</li>
         <!-- More (li) if the group has multiple updaters -->
        Allowed creators:
        <ul class="creators">
        <li class="creator" type="(type)>identifier</li>
         <!-- More (li) if the group has multiple creators -->
        Allowed readers
        <ul class="readers">
        <li class="reader" type="(type)">identifier</li>
         <!-- More (li) if the group has multiple readers -->
        Allowed viewers:
        <ul class="viewers">
        <li class="viewer" type="(type)">identifier</li>
         <!-- More (li) if the group has multiple viewers -->
        <!-- version v2 and greater -->
          Allowed optin:
          <ul class="optins">
           <li class="optin" type="(type)">identifier</li>
           <!-- More (li) if the group has multiple optins -->
          Allowed optout:
          <ul class="optouts">
           <li class="optout" type="(type)">identifier</li>
           <!-- More (li) if the group has multiple optouts -->
        <!-- end v2 -->
        <a rel="members" href="(root)/group/{regid}/member">members</a>
        <a rel="owners" href="(root)/group/{regid}/owner">owners</a>
  • If the group represents a course, course information is included in the group element

         Course information
         Quarter: <span class="course_qtr">win|spr|sum|aut</span>
         Year: <span class="course_year">YYYY</span>
         Curriculum: <span class="course_curr">curriculum code</span>
         Number: <span class="course_no">number</span>
         Section: <span class="course_sect">section letter</span>
         SLN: <span class="course_sln">SLN</span>
      Instructors: <ul class="course_instructors">
           <li class="course_instructor">UWNetID</li>


If-None-Match header matches group's ETag


Email-enabled, but no contact


Group not found


  • The response always includes an ETag header, which can be used on subsequent GETs and must be used on subsequent updates or deletes.