Skip to main content
GET
/
scim
/
v2
/
Groups
List SCIM groups
curl --request GET \
  --url https://api.attio.com/scim/v2/Groups \
  --header 'Authorization: <authorization>'
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:ListResponse"],
  "totalResults": 2,
  "startIndex": 1,
  "itemsPerPage": 2,
  "Resources": [
    {
      "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
      "id": "b5d3f8a1-c920-47e6-8b4d-3f17a9c82e50",
      "displayName": "Engineering",
      "members": [
        {
          "value": "3a8f5b2c-9e14-4d7a-b832-1c6f85d90e47",
          "$ref": "/scim/v2/Users/3a8f5b2c-9e14-4d7a-b832-1c6f85d90e47"
        }
      ],
      "meta": {
        "resourceType": "Group",
        "created": "2024-01-01T00:00:00.000Z",
        "lastModified": "2024-01-01T00:00:00.000Z"
      }
    }
  ]
}

​
Authorizations

​
Authorization
string
required
This API uses OAuth 2.0 with the authorization code grant flow.

​
Query

​
filter
string
A SCIM filter expression. Supported attributes: displayName. Example: displayName eq "Engineering".
​
startIndex
integer
default:"1"
1-based index of the first result to return.
​
count
integer
Maximum number of results to return. Capped at 100.
​
excludedAttributes
string
Comma-separated list of attributes to exclude from results. Supports "members" to omit the members array for efficiency.

​
Response

​
schemas
string[]
Always ["urn:ietf:params:scim:api:messages:2.0:ListResponse"].
​
totalResults
integer
Total number of groups matching the filter.
​
startIndex
integer
The 1-based index of the first result returned.
​
itemsPerPage
integer
The number of results returned in this page.
​
Resources
object[]
The list of groups. Each group has the same shape as the Get a SCIM group response.
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:ListResponse"],
  "totalResults": 2,
  "startIndex": 1,
  "itemsPerPage": 2,
  "Resources": [
    {
      "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
      "id": "b5d3f8a1-c920-47e6-8b4d-3f17a9c82e50",
      "displayName": "Engineering",
      "members": [
        {
          "value": "3a8f5b2c-9e14-4d7a-b832-1c6f85d90e47",
          "$ref": "/scim/v2/Users/3a8f5b2c-9e14-4d7a-b832-1c6f85d90e47"
        }
      ],
      "meta": {
        "resourceType": "Group",
        "created": "2024-01-01T00:00:00.000Z",
        "lastModified": "2024-01-01T00:00:00.000Z"
      }
    }
  ]
}