---
title: "Get Widget Config"
method: GET
path: "/chat/config/{firm_id}"
tags: ["Chat Widget"]
---

# Get Widget Config

`GET /chat/config/{firm_id}`

Fetch widget configuration for a firm.

Called on page load so the bubble can render with the correct theme
before the user opens the chat. Lightweight — no conversation created.

## Path parameters

- `firm_id` string, required

## Response `200`

Successful Response

- WidgetConfigResponse
  - `chat_widget_id` string, uuid, nullable
  - `firm_id` string, uuid, nullable
  - `accent_color` string, required
  - `secondary_color` string, nullable
  - `position` string, required
  - `greeting_message` string, required
  - `assistant_name` string, required
  - `enabled` boolean
  - `teaser_enabled` boolean
  - `teaser_message` string, nullable
  - `teaser_delay_seconds` integer
  - `show_online_status` boolean
  - `show_unread_badge` boolean
  - `tab_notification_enabled` boolean
  - `avatar_url` string, nullable
  - `avatar_video_url` string, nullable
  - `avatar_video_in_header` boolean
  - `launcher_avatar_enabled` boolean
  - `intro_video_enabled` boolean
  - `intro_video_url` string, nullable
  - `intro_video_autoplay_on_load` boolean
  - `attention_grabber_enabled` boolean
  - `attention_grabber_message` string, nullable
  - `attention_grabber_delay_seconds` integer
  - `idle_message` string, nullable
  - `idle_delay_seconds` integer, nullable
  - `quick_exit_enabled` boolean
  - `mobile_bottom_offset_px` integer, nullable
  - `default_language` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/4a81645b59f6/schema)