---
title: "Fetch Reactions"
method: GET
path: "/reactions"
tags: ["reaction"]
---

# Fetch Reactions

`GET /reactions`

This endpoint is used to fetch reactions for an org or a specific chat or message. 

 You can use `chat_id` and `message_id` to filter reactions specific to a chat or message. 

#### Response

The response is an array of JSON reaction objects. Refer to [the reaction object here](/api-reference/objects/the-reaction-object)

## Query parameters

- `chat_id` string — Use this option to fetch reactions of a specific chat. - For groups, enter the chat_id of the group. This will be a string that ends with @g.us - For 1-1 chats, enter the country_code + number of the recipient e.g. [919537851844@c.us](https://mailto:919537851844@c.us) (The @c.us is optional)
- `message_id` string — Use this option to fetch reactions of a specific message. - The message_id is a unique ID of a WA message on Periskope
- `offset` number — - The offset value for paginating the results - Default `0`
- `limit` number — - The maximum number of reactions to retrieve - Default `500`
- `start_time` string — - Filter for all reactions from the start_time timestamp onwards
- `end_time` string — - Filter for all reactions up to the end_time timestamp

## Headers

- `x-phone` string

## Response `200`

Reaction

- object
  - `from` number — The starting index of the reactions returned
  - `to` number — The ending index of the reactions returned
  - `start_time` string — The start_time of the reactions returned. The format should be YYYY-MM-DDTHH:MM:SSZ
  - `end_time` string — The end_time of the reactions returned. The format should be YYYY-MM-DDTHH:MM:SSZ
  - `count` number — The total number of reactions returned
  - `reactions` unknown[] — An array of reaction objects. Refer to [the reaction object here](/api-reference/objects/the-reaction-object)
    - unknown

---

[API](https://skmtc.net/periskope/apis/api-local.md) · [All operations](https://skmtc.net/periskope/apis/api-local/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/periskope/api-local/revisions/f2738ced87d8/schema)