# Get groups

Retrieve a list of all groups. **Required permissions**: `apps:read`, `[appId]:read`, `groups:read`, `apps:list`, `[appId]:list`, `groups:list`.

Endpoint: GET /v1/groups
Security: ClientAccessToken

## Security:

  - `ClientAccessToken` (unknown)
    oauth2

## Response 200 fields (application/json):

  - `result` (array, required)

  - `result.group_id` (string, required)
    Group ID

  - `result.name` (string, required)
    Group name

  - `result.description` (string)
    Group description

  - `result.created_at` (number, required)
    Date group was created in the tenant

  - `result.updated_at` (number, required)
    Date group was last updated

  - `result.custom_data` (object)
    Group custom data object

## Response 400 fields (application/json):

  - `message` (array, required)
    Example: Bad request

  - `error_code` (number, required)
    Example: 400