--- title: List groups description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > SCIM --- # List groups{% #list-groups %} {% tab title="v2" %} | Datadog site | API endpoint | | ----------------- | ---------------------------------------------------- | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/scim/Groups | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/scim/Groups | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/scim/Groups | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/scim/Groups | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/scim/Groups | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/scim/Groups | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/scim/Groups | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/scim/Groups | ### Overview List groups in the organization. Results are paginated by `startIndex` and `count` parameters. Results can be narrowed down by the `filter` parameter. This endpoint requires all of the following permissions: `user_access_invite``user_access_manage` ### Arguments #### Query Strings | Name | Type | Description | | ---------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | startIndex | integer | Specifies the start index to fetch the results (1-indexed). | | count | integer | Specifies the number of groups to be returned. | | filter | string | Specifies the url encoded filter to use to narrow down the results. Filters can be in the form of `displayName eq ` or `externalId eq ` or `id eq and members eq ` or `members eq and id eq `. | ### Response {% tab title="200" %} OK {% tab title="Model" %} List groups response object. | Parent field | Field | Type | Description | | ------------ | ------------ | --------- | ------------------------------------------------------------------------ | | | Resources | [object] | List of groups matching the request criteria. | | Resources | displayName | string | A human-readable name for the group. | | Resources | externalId | string | An identifier for the resource as defined by the provisioning client. | | Resources | id | string | The identifier of the resource. Not required when creating a group. | | Resources | members | [object] | A list of members belonging to the team. | | members | $ref | string | The URI corresponding to a resource that is a member of this group. | | members | display | string | Full name of the user. | | members | type | string | A label indicating the type of resource. Only supported value is "User". | | members | value | string | The identifier of the member of this group. | | Resources | meta | object | Metadata associated with a group. | | meta | created | date-time | The date and time the group was created. | | meta | lastModified | date-time | The date and time the group was last changed. | | meta | location | string | URL identifying the resource. | | meta | resourceType | string | Type of resource. | | Resources | schemas | [string] | Group JSON Schemas. | | | itemsPerPage | int64 | Number of groups returned per page. | | | schemas | [string] | List response JSON Schemas. | | | startIndex | int64 | Starting index of the groups for this page (1-indexed). | | | totalResults | int64 | Total number of groups matching the request criteria. | {% /tab %} {% tab title="Example" %} ```json { "Resources": [ { "displayName": "Group 1", "externalId": "group1", "id": "e43536e9-33fe-43f8-90b8-d3e39a7dd6ad", "members": [ { "$ref": "https://app.datadoghq.com/api/scim/v2/Users/d34a5f93-5690-4d3f-a293-f2ad5c7a82a4", "display": "John Doe", "type": "User", "value": "d34a5f93-5690-4d3f-a293-f2ad5c7a82a4" }, { "$ref": "https://app.datadoghq.com/api/scim/v2/Users/429ebce5-8ed3-4da9-9f1e-662f2dbc2fe6", "display": "Jane Doe", "type": "User", "value": "429ebce5-8ed3-4da9-9f1e-662f2dbc2fe6" } ], "meta": { "created": "2024-11-22T15:05:52.055138963Z", "lastModified": "2024-11-22T15:05:52.055139017Z", "location": "https://app.datadoghq.com/api/scim/v2/Groups/e43536e9-33fe-43f8-90b8-d3e39a7dd6ad", "resourceType": "Group" }, "schemas": [ "urn:ietf:params:scim:schemas:core:2.0:Group" ] }, { "displayName": "Group 2", "externalId": "group2", "id": "79ef0d28-f257-4829-97e6-d23d2a26cb1a", "members": [ { "$ref": "https://app.datadoghq.com/api/scim/v2/Users/29da9fb7-8fca-4e87-bf58-86652253deae", "display": "Alice Smith", "type": "User", "value": "29da9fb7-8fca-4e87-bf58-86652253deae" }, { "$ref": "https://app.datadoghq.com/api/scim/v2/Users/f85e3868-ad7b-47e3-a8a9-ff1eade2bbf9", "display": "Bob Smith", "type": "User", "value": "f85e3868-ad7b-47e3-a8a9-ff1eade2bbf9" } ], "meta": { "created": "2024-11-22T15:05:52.055139748Z", "lastModified": "2024-11-22T15:05:52.055139813Z", "location": "https://app.datadoghq.com/api/scim/v2/Groups/79ef0d28-f257-4829-97e6-d23d2a26cb1a", "resourceType": "Group" }, "schemas": [ "urn:ietf:params:scim:schemas:core:2.0:Group" ] } ], "itemsPerPage": 2, "schemas": [ "urn:ietf:params:scim:api:messages:2.0:ListResponse" ], "startIndex": 1, "totalResults": 2 } ``` {% /tab %} {% /tab %} {% tab title="400" %} Bad Request {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="429" %} Too many requests {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} ### Code Example ##### \# Curl command curl -X GET "https://api.datadoghq.com/api/v2/scim/Groups" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" {% /tab %}