# Get a list of tags

`GET /tags.json`

Authentication: no security requirement declared for this operation.

Responses:

- 200: notifications

Content type: application/json

Type: object

- `tags` (optional)
  Type: Array<object>
  
  Items:
    Type: object
    
    - `id` (optional)
      Type: integer
    
    - `text` (optional)
      Type: string
    
    - `name` (optional)
      Type: string
    
    - `count` (optional)
      Type: integer
    
    - `pm_count` (optional)
      Type: integer
    
    - `target_tag` (optional)
      Type: string; nullable

- `extras` (optional)
  Type: object
  
  - `categories` (optional)
    Type: Array<any>
    
    Items:
      Type: any

## Examples

### cURL

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

### JavaScript

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

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

### Python

```python
import requests

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