GET api/v2/addressbook/groups?count={count}&startIndex={startIndex}

This method returns a list of all the groups stored on the customer’s account if no parameters are provided.

Request Information

URI Parameters

Name	Description	Type	Additional information
count	Determines how many roles to return. (Default: 20).	string	Required
startIndex	Determines where to start outputting the roles from the list returned from the database. (Default: 0).	string	Required

Body Parameters

None.

Response Information

Resource Description

List of groups.

ResponseOfGroupDetailsV2[]

Name	Description	Type	Additional information
Error		Error	None.
ResponseData		ResponseDataOfGroupDetailsV2[]	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": [
      {
        "ID": "8df9b5e5-84b7-43b1-9b21-9f4dcea57d50",
        "Name": "sample string 2",
        "DateCreated": "2025-06-27T06:54:07.2507069+00:00",
        "DateModified": "2025-06-27T06:54:07.2507069+00:00",
        "NumberOfContacts": 4,
        "NumberOfContactsWithEmails": 5,
        "NumberOfContactsWithSMS": 6,
        "LastModifiedBy": "sample string 7",
        "Inherited": true,
        "PermissionLevel": 0,
        "AccountID": "d7fb478b-3b91-49e8-8abb-30ddcf0f315f"
      },
      {
        "ID": "8df9b5e5-84b7-43b1-9b21-9f4dcea57d50",
        "Name": "sample string 2",
        "DateCreated": "2025-06-27T06:54:07.2507069+00:00",
        "DateModified": "2025-06-27T06:54:07.2507069+00:00",
        "NumberOfContacts": 4,
        "NumberOfContactsWithEmails": 5,
        "NumberOfContactsWithSMS": 6,
        "LastModifiedBy": "sample string 7",
        "Inherited": true,
        "PermissionLevel": 0,
        "AccountID": "d7fb478b-3b91-49e8-8abb-30ddcf0f315f"
      }
    ]
  }
}

application/xml, text/xml

Sample:

<ResponseOfArrayOfGroupDetailsV2 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>
      <GroupDetailsV2>
        <ID>8df9b5e5-84b7-43b1-9b21-9f4dcea57d50</ID>
        <Name>sample string 2</Name>
        <DateCreated>2025-06-27T06:54:07.2507069+00:00</DateCreated>
        <DateModified>2025-06-27T06:54:07.2507069+00:00</DateModified>
        <NumberOfContacts>4</NumberOfContacts>
        <NumberOfContactsWithEmails>5</NumberOfContactsWithEmails>
        <NumberOfContactsWithSMS>6</NumberOfContactsWithSMS>
        <LastModifiedBy>sample string 7</LastModifiedBy>
        <Inherited>true</Inherited>
        <PermissionLevel>NONE</PermissionLevel>
        <AccountID>d7fb478b-3b91-49e8-8abb-30ddcf0f315f</AccountID>
      </GroupDetailsV2>
      <GroupDetailsV2>
        <ID>8df9b5e5-84b7-43b1-9b21-9f4dcea57d50</ID>
        <Name>sample string 2</Name>
        <DateCreated>2025-06-27T06:54:07.2507069+00:00</DateCreated>
        <DateModified>2025-06-27T06:54:07.2507069+00:00</DateModified>
        <NumberOfContacts>4</NumberOfContacts>
        <NumberOfContactsWithEmails>5</NumberOfContactsWithEmails>
        <NumberOfContactsWithSMS>6</NumberOfContactsWithSMS>
        <LastModifiedBy>sample string 7</LastModifiedBy>
        <Inherited>true</Inherited>
        <PermissionLevel>NONE</PermissionLevel>
        <AccountID>d7fb478b-3b91-49e8-8abb-30ddcf0f315f</AccountID>
      </GroupDetailsV2>
    </Detail>
  </ResponseData>
</ResponseOfArrayOfGroupDetailsV2>