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": "070b91fb-149c-4f87-bad8-15ec7ba0aa3f",
        "Name": "sample string 2",
        "DateCreated": "2022-01-27T11:55:28.4024874+00:00",
        "DateModified": "2022-01-27T11:55:28.4024874+00:00",
        "NumberOfContacts": 4,
        "NumberOfContactsWithEmails": 5,
        "NumberOfContactsWithSMS": 6,
        "LastModifiedBy": "sample string 7",
        "Inherited": true,
        "PermissionLevel": 0,
        "AccountID": "38575e5c-8914-4b49-ba7e-499c5ca25a3f"
      },
      {
        "ID": "070b91fb-149c-4f87-bad8-15ec7ba0aa3f",
        "Name": "sample string 2",
        "DateCreated": "2022-01-27T11:55:28.4024874+00:00",
        "DateModified": "2022-01-27T11:55:28.4024874+00:00",
        "NumberOfContacts": 4,
        "NumberOfContactsWithEmails": 5,
        "NumberOfContactsWithSMS": 6,
        "LastModifiedBy": "sample string 7",
        "Inherited": true,
        "PermissionLevel": 0,
        "AccountID": "38575e5c-8914-4b49-ba7e-499c5ca25a3f"
      }
    ]
  }
}

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>070b91fb-149c-4f87-bad8-15ec7ba0aa3f</ID>
        <Name>sample string 2</Name>
        <DateCreated>2022-01-27T11:55:28.4024874+00:00</DateCreated>
        <DateModified>2022-01-27T11:55:28.4024874+00:00</DateModified>
        <NumberOfContacts>4</NumberOfContacts>
        <NumberOfContactsWithEmails>5</NumberOfContactsWithEmails>
        <NumberOfContactsWithSMS>6</NumberOfContactsWithSMS>
        <LastModifiedBy>sample string 7</LastModifiedBy>
        <Inherited>true</Inherited>
        <PermissionLevel>NONE</PermissionLevel>
        <AccountID>38575e5c-8914-4b49-ba7e-499c5ca25a3f</AccountID>
      </GroupDetailsV2>
      <GroupDetailsV2>
        <ID>070b91fb-149c-4f87-bad8-15ec7ba0aa3f</ID>
        <Name>sample string 2</Name>
        <DateCreated>2022-01-27T11:55:28.4024874+00:00</DateCreated>
        <DateModified>2022-01-27T11:55:28.4024874+00:00</DateModified>
        <NumberOfContacts>4</NumberOfContacts>
        <NumberOfContactsWithEmails>5</NumberOfContactsWithEmails>
        <NumberOfContactsWithSMS>6</NumberOfContactsWithSMS>
        <LastModifiedBy>sample string 7</LastModifiedBy>
        <Inherited>true</Inherited>
        <PermissionLevel>NONE</PermissionLevel>
        <AccountID>38575e5c-8914-4b49-ba7e-499c5ca25a3f</AccountID>
      </GroupDetailsV2>
    </Detail>
  </ResponseData>
</ResponseOfArrayOfGroupDetailsV2>