---
title: "POST /v1/bots/{bot_id}/events/stream"
method: POST
path: "/v1/bots/{bot_id}/events/stream"
tags: ["Events"]
---

# POST /v1/bots/{bot_id}/events/stream

`POST /v1/bots/{bot_id}/events/stream`

## Path parameters

- `bot_id` string, required

## Request body

- object
  - `version` string, required
  - `page_size` integer — The maximum number of events to return. The service may return fewer than this value. The maximum value allowed is 100; value above 100 will be coerced to 100.
  - `page_token` string — A page token, received from a previous ListEvent call. Provide this to retrieve a subsequent page.
  - `start_time` string, required — The starting date for the time range of the events, inclusive.
  - `end_time` string, required — The ending date for the time range of the events, exclusive.
  - `event` string
  - `conversation_id` string
  - `user_id` string
  - `campaign_id` string
  - `filters` AttributeFilter[]
    - `key` string
    - `operator` string
    - `value` string[]

## Response `200`

A successful response.

- ListEventsResponse
  - `events` TrackingEvent[]
    - `id` string
    - `event` string
    - `bot_id` string
    - `version` string
    - `user_id` string
    - `channel_id` string
    - `channel_type` string
    - `conversation_id` string
    - `attributes` object
    - `timestamp` string, date-time
  - `next_page_token` string

---

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