# List groups

`GET https://api.agilitycredit.net/scim/v2/{tenantId}/Groups`

Docs page: https://apidocs.agilitycredit.com/sso/scim-api/list-groups · Tag: Groups

Returns the virtual groups derived from the tenant's role mapping. Optional
`filter` parameter — only `displayName eq "<name>"` is honoured.

Authentication: `Authorization: Bearer <api key>`.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `filter` | query |  | SCIM filter expression. Only `displayName eq "<name>"` is honoured. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | List of groups | GroupListResponse |
| 503 | SCIM provisioning is disabled on the tenant. | Error |

### Error bodies

503:

```json
{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "status": "503",
  "detail": "SCIM provisioning is disabled for this tenant"
}
```