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

NameDescriptionTypeAdditional 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[]
NameDescriptionTypeAdditional 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": "63e84658-4544-42fc-b4a5-692d2c417de6",
        "Name": "sample string 2",
        "DateCreated": "2024-05-30T07:27:22.0776834+00:00",
        "DateModified": "2024-05-30T07:27:22.0776834+00:00",
        "NumberOfContacts": 4,
        "NumberOfContactsWithEmails": 5,
        "NumberOfContactsWithSMS": 6,
        "LastModifiedBy": "sample string 7",
        "Inherited": true,
        "PermissionLevel": 0,
        "AccountID": "135accc0-7e67-4fcc-87d5-e5a59fdabbd9"
      },
      {
        "ID": "63e84658-4544-42fc-b4a5-692d2c417de6",
        "Name": "sample string 2",
        "DateCreated": "2024-05-30T07:27:22.0776834+00:00",
        "DateModified": "2024-05-30T07:27:22.0776834+00:00",
        "NumberOfContacts": 4,
        "NumberOfContactsWithEmails": 5,
        "NumberOfContactsWithSMS": 6,
        "LastModifiedBy": "sample string 7",
        "Inherited": true,
        "PermissionLevel": 0,
        "AccountID": "135accc0-7e67-4fcc-87d5-e5a59fdabbd9"
      }
    ]
  }
}

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>63e84658-4544-42fc-b4a5-692d2c417de6</ID>
        <Name>sample string 2</Name>
        <DateCreated>2024-05-30T07:27:22.0776834+00:00</DateCreated>
        <DateModified>2024-05-30T07:27:22.0776834+00:00</DateModified>
        <NumberOfContacts>4</NumberOfContacts>
        <NumberOfContactsWithEmails>5</NumberOfContactsWithEmails>
        <NumberOfContactsWithSMS>6</NumberOfContactsWithSMS>
        <LastModifiedBy>sample string 7</LastModifiedBy>
        <Inherited>true</Inherited>
        <PermissionLevel>NONE</PermissionLevel>
        <AccountID>135accc0-7e67-4fcc-87d5-e5a59fdabbd9</AccountID>
      </GroupDetailsV2>
      <GroupDetailsV2>
        <ID>63e84658-4544-42fc-b4a5-692d2c417de6</ID>
        <Name>sample string 2</Name>
        <DateCreated>2024-05-30T07:27:22.0776834+00:00</DateCreated>
        <DateModified>2024-05-30T07:27:22.0776834+00:00</DateModified>
        <NumberOfContacts>4</NumberOfContacts>
        <NumberOfContactsWithEmails>5</NumberOfContactsWithEmails>
        <NumberOfContactsWithSMS>6</NumberOfContactsWithSMS>
        <LastModifiedBy>sample string 7</LastModifiedBy>
        <Inherited>true</Inherited>
        <PermissionLevel>NONE</PermissionLevel>
        <AccountID>135accc0-7e67-4fcc-87d5-e5a59fdabbd9</AccountID>
      </GroupDetailsV2>
    </Detail>
  </ResponseData>
</ResponseOfArrayOfGroupDetailsV2>