Coruson API

<back to all web services

GetUserGroups

Coruson Users

Requires Authentication
GetUserGroups Parameters:
NameParameterData TypeRequiredDescription
UserGroupIdqueryGuidNoFilter by the Id of the User Group.
NamequerystringNoFilter by the name of the User Group.
DescriptionquerystringNoFilter by the description of the User Group.
IsSystemqueryBooleanFilterYesFilter by User Groups that were either creted by Coruson or by a user.

Allowable Values

  • All
  • True
  • False
IsActivequeryBooleanFilterYesFilter by the active status of the User Group. By default, active and archived user groups will be included.

Allowable Values

  • All
  • True
  • False
OrderByqueryUserGroupOrderYesProperty to order by in Ascending order. Default is 'Name'.

Allowable Values

  • Default
  • Name
OrderByDescqueryUserGroupOrderYesProperty to order by in Descending order.

Allowable Values

  • Default
  • Name
ThenByqueryUserGroupOrderYesSecond Property to order by in Ascending order. NOTE: If this value is the same as either the OrderBy or OrderByDesc values, then it will be ignored.

Allowable Values

  • Default
  • Name
ThenByDescqueryUserGroupOrderYesSecond Property to order by in Descending order. NOTE: If this value is the same as either the OrderBy or OrderByDesc values, then it will be ignored.

Allowable Values

  • Default
  • Name
PagingRequestBase<T> Parameters:
NameParameterData TypeRequiredDescription
SkipformIntegerNoNumber of items to skip before returning results. Minimum suitable value is 0 and is also the default value.
TakeformIntegerNoNumber of items to return per page. Must be a number in the range 1-100. Default value is 100.
OrderByformEnumNoOrder By
OrderByDescformEnumNoOrder By Descending
ThenByformEnumNoThen By
ThenByDescformEnumNoThen By Descending
RequestBase Parameters:
NameParameterData TypeRequiredDescription
VersionformintNo
GetUserGroupsResponse Parameters:
NameParameterData TypeRequiredDescription
UserGroupsformList<UserGroup>No
GetResponseBase Parameters:
NameParameterData TypeRequiredDescription
TotalResultsformintNo
SkipformintNo
TakeformintNo
LinksformList<Link>No
ResponseBase Parameters:
NameParameterData TypeRequiredDescription
StatusDescriptionformstringNo
ResponseStatusformResponseStatusNo
Link Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
RequestUrlformstringNo
MethodformstringNo
UserGroup Parameters:
NameParameterData TypeRequiredDescription
UserGroupIdformGuidNo
NameformstringNo
DescriptionformstringNo
IsSystemformboolNo
IsActiveformboolNo
MembersformList<string>No

To override the Content-type in your clients, use the HTTP Accept Header, append the .soap12 suffix or ?format=soap12

HTTP + SOAP12

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

                    POST /soap12 HTTP/1.1 
Host: platform.gaelenlighten.com 
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
    <soap12:Body>

<GetUserGroups xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.servicestack.net/types">
  <Version>0</Version>
  <Skip>0</Skip>
  <Take>0</Take>
  <OrderBy>Default</OrderBy>
  <OrderByDesc>Default</OrderByDesc>
  <ThenBy>Default</ThenBy>
  <ThenByDesc>Default</ThenByDesc>
  <UserGroupId>00000000-0000-0000-0000-000000000000</UserGroupId>
  <Name>String</Name>
  <Description>String</Description>
  <IsSystem>All</IsSystem>
  <IsActive>All</IsActive>
</GetUserGroups>

    </soap12:Body>
</soap12:Envelope>
                    
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
    <soap12:Body>

<GetUserGroupsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.servicestack.net/types">
  <StatusDescription>String</StatusDescription>
  <ResponseStatus>
    <ErrorCode>String</ErrorCode>
    <Message>String</Message>
    <StackTrace>String</StackTrace>
    <Errors>
      <ResponseError>
        <ErrorCode>String</ErrorCode>
        <FieldName>String</FieldName>
        <Message>String</Message>
        <Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </Meta>
      </ResponseError>
    </Errors>
    <Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </Meta>
  </ResponseStatus>
  <TotalResults>0</TotalResults>
  <Skip>0</Skip>
  <Take>0</Take>
  <Links>
    <Link>
      <Name>String</Name>
      <RequestUrl>String</RequestUrl>
      <Method>String</Method>
    </Link>
  </Links>
  <UserGroups>
    <UserGroup>
      <UserGroupId>00000000-0000-0000-0000-000000000000</UserGroupId>
      <Name>String</Name>
      <Description>String</Description>
      <IsSystem>false</IsSystem>
      <IsActive>false</IsActive>
      <Members xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>String</d4p1:string>
      </Members>
    </UserGroup>
  </UserGroups>
</GetUserGroupsResponse>

    </soap12:Body>
</soap12:Envelope>