List Groups

This endpoint returns all Groups that exist in your organization.

Available filter fields:

• name
• disabled
• type

Sample Request

  curl -X GET \
  https://console.jumpcloud.com/api/v2/groups \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'

Basic Parameters

Parameter	Description
Fields	The comma separated fields included in the returned records. If omitted, the default list of fields will be returned.
Filter	A filter to apply to the query. Filter structure: <field>:<operator>:<value>. field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. Note: v1 operators differ from v2 operators. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: GET /api/v2/groups?filter=name:eq:Test+Group.
Limit	The number of records to return at once. Limited to 100.

Advanced Parameters

Parameter	Description
Organization ID	Organization identifier that can be obtained from console settings.
Skip	The offset into the records to return.
Sort	The comma separated fields used to sort the collection. Default sort is ascending, prefix with - to sort descending.
X Unfiltered Total Count	If provided in the request with any non-empty value, this header will be returned on the response populated with the total count of objects without filters taken into account.

Example Output

[
    {
        "attributes": {},
        "description": "Description of a Group",
        "email": "E-mail address associated with a Group",
        "id": "ObjectId uniquely identifying a Group.",
        "name": "Display name of a Group.",
        "type": "The group type."
    }
]

Workflow Library Example

Scan and Enforce Full Disk Encryption Jumpcloud Policy Daily

Preview this Workflow on desktop