---
title: "List users who reacted with emoji"
method: GET
path: "/channels/{channel_id}/messages/{message_id}/reactions/{emoji}"
tags: ["Channels"]
---

# List users who reacted with emoji

`GET /channels/{channel_id}/messages/{message_id}/reactions/{emoji}`

## Request

- Base URL: `https://web.fluxer.app/api/v1`
- URL: `https://web.fluxer.app/api/v1/channels/{channel_id}/messages/{message_id}/reactions/{emoji}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`

Retrieves a paginated list of users who reacted to a message with a specific emoji. Supports pagination via limit and after parameters. Returns user objects for each reaction.

## Path parameters

- `channel_id` union, required
  - string, snowflake
  - integer
- `message_id` union, required
  - string, snowflake
  - integer
- `emoji` string, required: The emoji identifier

## Query parameters

- `limit` integer: Maximum number of users to return (1-100)
- `after` union
  - string, snowflake
  - integer

## Response `200`

Success

- UserPartialResponse[]
  - `id` string, snowflake, required
  - `username` string, required: The username of the user, not unique across the platform
  - `discriminator` string, required: The four-digit discriminator tag of the user
  - `global_name` string, nullable, required: The display name of the user, if set
  - `avatar` string, nullable, required: The hash of the user avatar image
  - `avatar_color` integer, required
  - `bot` boolean: Whether the user is a bot account
  - `system` boolean: Whether the user is an official system user
  - `flags` integer, required: The public flags on the user account
  - `mention_flags` 0 | 1 | 2: Reply mention preference

## Other responses

- `400`: Bad Request - The request was malformed or contained invalid data
- `401`: Unauthorized - Authentication is required or the token is invalid
- `403`: Forbidden - You do not have permission to perform this action
- `429`: Too Many Requests - You are being rate limited
- `500`: Internal Server Error - An unexpected error occurred

## Changes

> 39 revisions in range; 2 not diffed.

- **2026-09-18** `dd0ad4ea1c88`: 2 breaking, 2 info
  - the response property `items/avatar` became nullable for the status `200`
  - the response property `items/global_name` became nullable for the status `200`
  - response property `items/avatar` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `items/global_name` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2026-09-06** `a52a2cf49d9b`: 32 warning, 200 info
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `400`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `401`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `403`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `500`
  - …228 more
  - …this revision’s changelog is incomplete
- …earlier changes not shown

[Operation history](https://skmtc.dev/fluxer/apis/fluxer-api/changes/channels/:channel_id/messages/:message_id/reactions/:emoji/get.md)

---

[API](https://skmtc.dev/fluxer/apis/fluxer-api.md) - [All operations](https://skmtc.dev/fluxer/apis/fluxer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fluxer/apis/fluxer-api/revisions/9534dbe80d92?raw)