# Retrieves a list of categories

`GET /categories.json`

Authentication: no security requirement declared for this operation.

Parameters:

- `include_subcategories` (query, boolean, optional)
  Type: boolean
  
  enum: [true]

Responses:

- 200: success response

Content type: application/json

Type: any

- `category_list` (required)
  Type: object
  
  - `can_create_category` (required)
    Type: boolean
  
  - `can_create_topic` (required)
    Type: boolean
  
  - `categories` (required)
    Type: Array<object>
    
    Items:
      Type: object
      
      - `id` (required)
        Type: integer
      
      - `name` (required)
        Type: string
      
      - `color` (required)
        Type: string
      
      - `text_color` (required)
        Type: string
      
      - `style_type` (required)
        Type: string
      
      - `emoji` (required)
        Type: string; nullable
      
      - `icon` (required)
        Type: string; nullable
      
      - `slug` (required)
        Type: string
      
      - `topic_count` (required)
        Type: integer
      
      - `post_count` (required)
        Type: integer
      
      - `position` (required)
        Type: integer
      
      - `description` (required)
        Type: string; nullable
      
      - `description_text` (required)
        Type: string; nullable
      
      - `description_excerpt` (required)
        Type: string; nullable
      
      - `topic_url` (required)
        Type: string; nullable
      
      - `read_restricted` (required)
        Type: boolean
      
      - `permission` (required)
        Type: integer
      
      - `notification_level` (required)
        Type: integer
      
      - `can_edit` (required)
        Type: boolean
      
      - `topic_template` (required)
        Type: string; nullable
      
      - `topic_title_placeholder` (required)
        Type: string; nullable
      
      - `has_children` (required)
        Type: boolean
      
      - `subcategory_count` (required)
        Type: integer; nullable
      
      - `sort_order` (required)
        Type: string; nullable
      
      - `sort_ascending` (required)
        Type: string; nullable
      
      - `show_subcategory_list` (required)
        Type: boolean
      
      - `num_featured_topics` (required)
        Type: integer
      
      - `default_view` (required)
        Type: string; nullable
      
      - `subcategory_list_style` (required)
        Type: string
      
      - `default_top_period` (required)
        Type: string
      
      - `default_list_filter` (required)
        Type: string
      
      - `minimum_required_tags` (required)
        Type: integer
      
      - `navigate_to_first_post_after_read` (required)
        Type: boolean
      
      - `topics_day` (required)
        Type: integer
      
      - `topics_week` (required)
        Type: integer
      
      - `topics_month` (required)
        Type: integer
      
      - `topics_year` (required)
        Type: integer
      
      - `topics_all_time` (required)
        Type: integer
      
      - `is_uncategorized` (optional)
        Type: boolean
      
      - `subcategory_ids` (required)
        Type: Array<any>
        
        Items:
          Type: any
      
      - `subcategory_list` (optional)
        Type: Array<any>; nullable
        
        Items:
          Type: any
      
      - `uploaded_logo` (required)
        Type: string; nullable
      
      - `uploaded_logo_dark` (required)
        Type: string; nullable
      
      - `uploaded_background` (required)
        Type: string; nullable
      
      - `uploaded_background_dark` (required)
        Type: string; nullable
      
      Additional properties: false
  
  Additional properties: false

Additional properties: false

## Examples

### cURL

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

### JavaScript

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

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

### Python

```python
import requests

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