Skip to main content

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

ParameterDescription
FieldsThe comma separated fields included in the returned records.If omitted, the default list of fields will be returned.
FilterA 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.
LimitThe number of records to return at once. Limited to 100.

Advanced Parameters

ParameterDescription
Organization IDOrganization identifier that can be obtained from console settings.
SkipThe offset into the records to return.
SortThe comma separated fields used to sort the collection.Default sort is ascending, prefix with - to sort descending.
X Unfiltered Total CountIf 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

Workflow LibraryPreview this Workflow on desktop