# List groups

`GET /groups.json`

Authentication: no security requirement declared for this operation.

Responses:

- 200: response

Content type: application/json

Type: any

- `groups` (required)
  Type: Array<object>
  
  Items:
    Type: object
    
    - `id` (required)
      Type: integer
    
    - `automatic` (required)
      Type: boolean
    
    - `name` (required)
      Type: string
    
    - `display_name` (required)
      Type: string
    
    - `user_count` (optional)
      Type: integer
    
    - `mentionable_level` (required)
      Type: integer
    
    - `messageable_level` (required)
      Type: integer
    
    - `visibility_level` (required)
      Type: integer
    
    - `primary_group` (required)
      Type: boolean
    
    - `title` (required)
      Type: string; nullable
    
    - `grant_trust_level` (required)
      Type: string; nullable
    
    - `incoming_email` (required)
      Type: string; nullable
    
    - `has_messages` (required)
      Type: boolean
    
    - `flair_url` (required)
      Type: string; nullable
    
    - `flair_bg_color` (required)
      Type: string; nullable
    
    - `flair_color` (required)
      Type: string; nullable
    
    - `bio_raw` (required)
      Type: string; nullable
    
    - `bio_cooked` (required)
      Type: string; nullable
    
    - `bio_excerpt` (required)
      Type: string; nullable
    
    - `public_admission` (required)
      Type: boolean
    
    - `public_exit` (required)
      Type: boolean
    
    - `allow_membership_requests` (required)
      Type: boolean
    
    - `full_name` (required)
      Type: string; nullable
    
    - `default_notification_level` (required)
      Type: integer
    
    - `membership_request_template` (required)
      Type: string; nullable
    
    - `is_group_user` (optional)
      Type: boolean
    
    - `is_group_owner` (optional)
      Type: boolean
    
    - `members_visibility_level` (required)
      Type: integer
    
    - `can_see_members` (required)
      Type: boolean
    
    - `can_admin_group` (required)
      Type: boolean
    
    - `can_edit_group` (optional)
      Type: boolean
    
    - `publish_read_state` (required)
      Type: boolean
    
    Additional properties: false

- `extras` (required)
  Type: object
  
  - `type_filters` (required)
    Type: Array<any>
    
    Items:
      Type: any
  
  Additional properties: false

- `total_rows_groups` (required)
  Type: integer

- `load_more_groups` (required)
  Type: string

Additional properties: false

## Examples

### cURL

```bash
curl -X GET 'https://discourse.example.com/groups.json'
```

### JavaScript

```javascript
const response = await fetch('https://discourse.example.com/groups.json', {
  method: 'GET',
});

const data = await response.text();
```

### Python

```python
import requests

response = requests.get('https://discourse.example.com/groups.json')
print(response.text)
```