---
title: "Find events"
method: GET
path: "/events"
tags: ["events"]
---

# Find events

`GET /events`

All events are retrieved using this route and using the paramaters as filters you can focus on rooms, bots, or users.

## Query parameters

- `roomId` integer
- `botId` string
- `type` string
- `actionType` string
- `sort` string
- `botDataId` string
- `botActionId` string
- `userId` string
- `createdAt` string
- `updatedAt` string
- `limit` integer
- `offset` integer

## Response `200`

Success, returns all Events

- EventResponse[]
  - `id` string — The UUID of the specified event
  - `log` string — Human readable log line describing the event and its context it stores
  - `context` object — A object, typically JSON, that contains the information to describe an event
  - `actionType` string — This is the type of the event
  - `roomId` integer — The room ID in which the event deals with
  - `botId` string — The bot ID in which the event deals with
  - `botDataId` string — The bot data ID in which the event deals with
  - `botActionId` string — The bot action ID in which the event deals with
  - `userId` string — The user ID in which the event deals with

## Other responses

- `400` — Bad Request
- `401` — Authentication Error
- `404` — Resource Not Found
- `default` — Error

## Changes

- **2019-03-14** (v1) `61c43b67559b` — 2 info
  - added the new optional `query` request parameter `createdAt`
  - added the new optional `query` request parameter `updatedAt`
- **2019-02-05** (v1) `445275b9f9b6` — 1 info
  - added the new optional `query` request parameter `actionType`
- **2018-08-17** (v1) `abcc89493a3e` — 1 info
  - added the new optional `query` request parameter `type`
- **2018-08-14** (v1) `21fd8854b2a5` — 1 info
  - added the new optional `query` request parameter `sort`
- **2018-03-30** (v1) `4ca6b20ef8df` — 5 warning
  - deleted the `query` request parameter `actionType`
  - deleted the `query` request parameter `createdAt`
  - deleted the `query` request parameter `sort`
  - deleted the `query` request parameter `type`
  - …1 more

[Change history](https://skmtc.dev/salesforce/apis/refocus-api/changes/events/get.md)

---

[API](https://skmtc.dev/salesforce/apis/refocus-api.md) · [All operations](https://skmtc.dev/salesforce/apis/refocus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/salesforce/refocus-api/revisions/42c2153b047e/schema)