Purpose: get a list of user groups. The list of groups may be presented to the user as a simple list of group names, where each group name includes a hyperlink to access a list of group members. Group names could, for example, mirror the geographic distribution of CHWs, with a separate group name used for each health district. Access control may be applied, with each web user having access to one or more groups associated with the CommCare domain. Only groups that the user is permitted to access are included in the output.
Base URL: https://www.commcarehq.org/a/[domain]/api/[version]/group/
Authentication: For more information, please review https://dimagi.atlassian.net/wiki/x/LwXKfw.
Input parameters:
Name | Description | Example |
---|---|---|
Format | Return data format (optional) | format=xml |
Output values:
Name | Description | Example |
---|---|---|
group_id | Group UUID | ac9d34ff59cf6388e4f5804b12276d8a |
group_name | Group name (e.g. health district) | Senahú |
Sample usage:
https://www.commcarehq.org/a/demo/api/v0.4/group/
Sample output:
{ "meta": { "limit": 20, "next": null, "offset": 0, "previous": null, "total_count": 3 }, "objects": [ { "case_sharing": false, "domain": "cloudcaredemo", "id": "1eb59d6938fc7e510254d8c2f63d944f", "metadata": {}, "name": "Wozzle", "path": [], "reporting": true, "users": ["91da6b1c78699adfb8679b741caf9f00", "8a642f722c9e617eeed29290e409fcd5"] }, ... ] }