---
title: "GET /guilds/{guild_id}/widget.json"
method: GET
path: "/guilds/{guild_id}/widget.json"
---

# GET /guilds/{guild_id}/widget.json

`GET /guilds/{guild_id}/widget.json`

## Response `200`

200 response for get_guild_widget

- WidgetResponse
  - `id` string, snowflake, required
  - `name` string, required
  - `instant_invite` string, nullable, required
  - `channels` WidgetChannel[], required
    - `id` string, snowflake, required
    - `name` string, required
    - `position` integer, required
  - `members` WidgetMember[], required
    - `id` string, required
    - `username` string, required
    - `discriminator` '0000', required
    - `avatar` unknown, required
    - `status` string, required
    - `avatar_url` string, uri, required
    - `activity` WidgetActivity
      - `name` string, required
    - `deaf` boolean
    - `mute` boolean
    - `self_deaf` boolean
    - `self_mute` boolean
    - `suppress` boolean
    - `channel_id` string, snowflake
  - `presence_count` integer, required

## Other responses

- `429` — Client ratelimited response
- `4XX` — Client error response

## Changes

> 58 revisions in range; 1 could not be searched.

- **2026-02-04** `e200830e509a` — 2 info
  - the response property `instant_invite` became required for the status `200`
  - the response property `members/items/avatar` became required for the status `200`

[Change history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/guilds/:guild_id/widget.json/get.md)

---

[API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.dev/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discord/discord-http-api-preview/revisions/49efa428e0dd/schema)