---
title: "List Widgets"
method: GET
path: "/api/livechat/widgets"
tags: ["livechat", "livechat"]
---

# List Widgets

`GET /api/livechat/widgets`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/livechat/widgets`
- Auth: none declared

List all LiveChat widgets for the current workspace.

## Response `200`

Successful Response

- WidgetResponse[]
  - `id` integer, required
  - `widget_key` string, required
  - `name` string, required
  - `theme` object, required
  - `require_identification` boolean, required
  - `identification_fields` string[], required
  - `identification_field_config` object, nullable
  - `show_visitor_history` boolean, required
  - `allowed_domains` string[], required
  - `rate_limit_per_minute` integer, required
  - `is_active` boolean, required
  - `embed_code` string, required
  - `calendly_url` string, nullable
  - `contact_form_fields` string[]
  - `contact_form_field_config` object, nullable
  - `enable_search_action` boolean
  - `enable_form_action` boolean
  - `enable_calendar_action` boolean
  - `proactive_greeting` object, nullable
  - `allow_attachments` boolean
  - `max_attachment_size_mb` integer
  - `allowed_attachment_types` string[]
  - `sound_enabled` boolean
  - `site_search_enabled` boolean
  - `website_url` string, nullable
  - `ecommerce_platform` string, nullable
  - `allow_voice` boolean
  - `allow_text_during_call` boolean
  - `allow_avatar` boolean
  - `show_branding` boolean
  - `can_hide_branding` boolean
  - `max_voice_duration_seconds` integer
  - `voice_stt_model` string
  - `voice_greeting` string
  - `display_mode` 'chat' | 'voice_only' | 'headless'
  - `localization` object
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)