---
title: "Get Extension-wide Viewer State"
method: GET
path: "/extension_viewer_state"
tags: ["Admin Extension State"]
---

# Get Extension-wide Viewer State

`GET /extension_viewer_state`

If the request includes a query parameter list of Twitch user IDs and the
requesting JWT auth token is admin-level, returns a mapping of those user
IDs to their extension-side viewer state, removing any that are not found.

If no list of IDs is provided and the JWT auth token is viewer-level,
returns a JSON object of the viewer's extension-wide state. This is
associated with the current viewer, but across all channels.

## Query parameters

- `user_ids` unknown[] — Optional comma-separated list of Twitch user IDs.
  - unknown

## Response `200`

One or more viewer state objects depending on request.

- union
  - object — Any JSON serializable data
  - object — A mapping of user IDs to viewer extension state

---

[API](https://skmtc.net/muxy/apis/muxy-s-extension-development-kit.md) · [All operations](https://skmtc.net/muxy/apis/muxy-s-extension-development-kit/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muxy/muxy-s-extension-development-kit/versions/21b37686a542/schema)