# List badges

`GET /admin/badges.json`

Authentication: no security requirement declared for this operation.

Responses:

- 200: success response

Content type: application/json

Type: any

- `badges` (required)
  Type: Array<object>
  
  Items:
    Type: object
    
    - `id` (required)
      Type: integer
    
    - `name` (required)
      Type: string
    
    - `description` (required)
      Type: string
    
    - `grant_count` (required)
      Type: integer
    
    - `allow_title` (required)
      Type: boolean
    
    - `multiple_grant` (required)
      Type: boolean
    
    - `icon` (required)
      Type: string
    
    - `image_url` (required)
      Type: string; nullable
    
    - `listable` (required)
      Type: boolean
    
    - `enabled` (required)
      Type: boolean
    
    - `badge_grouping_id` (required)
      Type: integer
    
    - `system` (required)
      Type: boolean
    
    - `long_description` (required)
      Type: string
    
    - `slug` (required)
      Type: string
    
    - `manually_grantable` (required)
      Type: boolean
    
    - `query` (required)
      Type: string; nullable
    
    - `trigger` (required)
      Type: integer; nullable
    
    - `target_posts` (required)
      Type: boolean
    
    - `auto_revoke` (required)
      Type: boolean
    
    - `show_posts` (required)
      Type: boolean
    
    - `i18n_name` (optional)
      Type: string; nullable
    
    - `image_upload_id` (required)
      Type: integer; nullable
    
    - `badge_type_id` (required)
      Type: integer
    
    - `show_in_post_header` (required)
      Type: boolean
    
    Additional properties: false

- `badge_types` (required)
  Type: Array<object>
  
  Items:
    Type: object
    
    - `id` (required)
      Type: integer
    
    - `name` (required)
      Type: string
    
    - `sort_order` (required)
      Type: integer
    
    Additional properties: false

- `badge_groupings` (required)
  Type: Array<object>
  
  Items:
    Type: object
    
    - `id` (required)
      Type: integer
    
    - `name` (required)
      Type: string
    
    - `description` (required)
      Type: string; nullable
    
    - `position` (required)
      Type: integer
    
    - `system` (required)
      Type: boolean
    
    Additional properties: false

- `admin_badges` (required)
  Type: object
  
  - `protected_system_fields` (required)
    Type: Array<any>
    
    Items:
      Type: any
  
  - `triggers` (required)
    Type: object
    
    - `user_change` (required)
      Type: integer
    
    - `none` (required)
      Type: integer
    
    - `post_revision` (required)
      Type: integer
    
    - `trust_level_change` (required)
      Type: integer
    
    - `post_action` (required)
      Type: integer
    
    Additional properties: false
  
  - `badge_ids` (required)
    Type: Array<any>
    
    Items:
      Type: any
  
  - `badge_grouping_ids` (required)
    Type: Array<any>
    
    Items:
      Type: any
  
  - `badge_type_ids` (required)
    Type: Array<any>
    
    Items:
      Type: any
  
  Additional properties: false

Additional properties: false

## Examples

### cURL

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

### JavaScript

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

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

### Python

```python
import requests

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