# List icons

div
strong
🔨 In Development
 — This section is still being developed and may change.


Retrieve the catalog of predefined UI icons available across the platform. Icons can be referenced by `iconId` in APIs (e.g., preset prompts) or overridden with a custom icon object.

## Returns

A list of [Icon objects](/docs/api-reference/objects/icon-object).


```bash
curl "https://api.freddy.aitronos.com/v1/icons" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/icons",
    headers={"Authorization": f"Bearer {api_key}"}
)

icons = response.json()
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/icons', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const icons = await response.json();
```

## Response


```json
{
  "icons": [
    {
      "id": "icon_welcome",
      "name": "Welcome",
      "url": "https://cdn.aitronos.com/icons/icon-welcome.svg",
      "alt": "Speech bubble icon",
      "category": "general"
    },
    {
      "id": "icon_support",
      "name": "Support",
      "url": "https://cdn.aitronos.com/icons/icon-support.svg",
      "alt": "Lifebuoy icon",
      "category": "support"
    }
  ],
  "total": 2
}
```