GET api/v1/addressbook/groups/{groupID}

This method returns a group stored on any account.

Request Information

URI Parameters

Name	Description	Type	Additional information
groupID	Unique indentifier for the group in question.	globally unique identifier	Required

Body Parameters

None.

Response Information

Resource Description

Group Details.

TwoSms.CustomerPortalRole.API.Misc.ResponseOfTwoSms.CustomerPortalRole.API.AddressBooks.GroupDetails

Name	Description	Type	Additional information
Error		TwoSms.CustomerPortalRole.API.Misc.Error	None.
ResponseData		TwoSms.CustomerPortalRole.API.Misc.ResponseDataOfTwoSms.CustomerPortalRole.API.AddressBooks.GroupDetails	None.

Response Formats

application/json, text/json

Sample:

{
  "Error": {
    "ErrorCode": "sample string 1",
    "ErrorReason": "sample string 2"
  },
  "ResponseData": {
    "Identification": {
      "UserId": "sample string 1"
    },
    "Result": "sample string 1",
    "Detail": {
      "GroupID": "ccf454c5-8198-4dc6-a8fe-7300d9a8aad5",
      "Groupname": "sample string 2",
      "DateCreated": "2026-02-02T00:25:29.2029033+00:00",
      "DateModified": "2026-02-02T00:25:29.2029033+00:00",
      "Contacts": 4,
      "LastModifiedBy": "sample string 5",
      "PermissionDetails": "sample string 6"
    }
  }
}

application/xml, text/xml

Sample:

<ResponseOfGroupDetails xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Error>
    <ErrorCode>sample string 1</ErrorCode>
    <ErrorReason>sample string 2</ErrorReason>
  </Error>
  <ResponseData>
    <Result>sample string 1</Result>
    <Identification>
      <UserId>sample string 1</UserId>
    </Identification>
    <Detail>
      <GroupID>ccf454c5-8198-4dc6-a8fe-7300d9a8aad5</GroupID>
      <Groupname>sample string 2</Groupname>
      <DateCreated>2026-02-02T00:25:29.2029033+00:00</DateCreated>
      <DateModified>2026-02-02T00:25:29.2029033+00:00</DateModified>
      <Contacts>4</Contacts>
      <LastModifiedBy>sample string 5</LastModifiedBy>
      <PermissionDetails>sample string 6</PermissionDetails>
      <PermissionLevel>7</PermissionLevel>
      <GroupAccountID>7756c45c-e26f-44f7-b5aa-2f5b03e366d5</GroupAccountID>
      <ParentGroupID>9218d49f-24f3-4fb5-aade-e7c4e6c13ae9</ParentGroupID>
    </Detail>
  </ResponseData>
</ResponseOfGroupDetails>