GET /sites/{siteid}/categories/profile/{categoryid}/groups

Description

Get all profile groups in a profile category

Parameters

Name Type Required Optional Searchable Note
siteid numeric REQUIRED, Passed via URI
categoryid numeric REQUIRED, Passed via URI
groupname string via search string

Examples

Example Request

http://devsandbox.targetsolutions.com/v1/sites/{siteid}/categories/profile/{categoryid}/groups

Example Request with Search String

http://devsandbox.targetsolutions.com/v1/sites/{siteid}/categories/profile/{categoryid}/groups?q={"groupname":"random groupname"}

Example Header

GET /sites/{siteid}/categories/profile/{categoryid}/groups HTTP/1.1
Host: http://devsandbox.targetsolutions.com/v1
AccessToken: 04virRrQ13kkX58yPNATGw==
Cache-Control: no-cache

Possible Results Sets

Results Set

{
  "profilegroups":[
    {
      "links":{
        "users":"http://devsandbox.targetsolutions.com/v1/sites/12/categories/profile/5468/groups/307414/users",
        "resourcelink":"http://devsandbox.targetsolutions.com/v1/sites/12/categories/profile/5468/groups/307414"
      },
      "usercount":1,
      "groupid":307414,
      "siteid":12,
      "categoryid":5468,
      "groupname":"Dave's Group 2020"
    }
  ],
  "pagination":{
    "next":"http://devsandbox.targetsolutions.com/v1/sites/categories/profile/5468/groups?startrow=2&limit=1"
  }
}

No Results Set

{
  "httpcode":200,
  "moreinfo":"http://developers.targetsolutions.com/v1/responsecodes/901",
  "developermessage":"The request returned zero results.",
  "statuscode":901,
  "status":"ok"
}

Access Denied Set

{
  "httpcode":401,
  "moreinfo":"http://developers.targetsolutions.com/v1/responsecodes/800",
  "developermessage":"A request was made to a resource that you do not have ownership of.",
  "statuscode":800,
  "status":"access denied"
}