---
title: "List Events"
method: GET
path: "/event"
tags: ["Event"]
---

# List Events

`GET /event`

Retrieve a list of events

## Query parameters

- `id` string
- `created_at` string
- `updated_at` string
- `conversation_id` string
- `organisation_id` string
- `type` string
- `source_type` string
- `target_type` string
- `metadata` string
- `source_employee_id` string
- `source_api_token_id` string
- `source_comment_id` string
- `source_channel_id` string
- `source_recipient_id` string
- `target_employee_id` string
- `target_comment_id` string
- `target_message_id` string
- `target_tag_id` string
- `target_message_action_id` string
- `target_inbox_id` string
- `select` string
- `order` string
- `offset` string
- `limit` string

## Headers

- `Range` string
- `Range-Unit` string

## Response `200`

OK

- Event[]
  - `id` string, uuid — Event ID
  - `created_at` string, timestamp with time zone — Event creation date
  - `updated_at` string, timestamp with time zone — Latest update
  - `conversation_id` string, uuid — Conversation ID
  - `organisation_id` string, uuid — Organisation ID
  - `type` 'assign' | 'unassign' | 'close' | 'reopen' | 'comment' | 'mention' | 'inbound' | 'outbound' | 'tag' | 'untag' | 'sending_error' | 'message_bounce_error' | 'submit' | 'subject_change' | 'submission_error' | 'read' | 'archive' | 'action_click' | 'inbox_change' | 'spam' | 'ham' | 'contact_deletion' | 'external_id_change' | 'message_reaction' | 'form_submission_start' | 'inbound_voice_call', public.event_type — Type of event
  - `source_type` 'employee' | 'channel' | 'comment' | 'message' | 'tag' | 'recipient' | 'message_action' | 'api_token' | 'service_role' | 'inbox' | 'form_submission' | 'cs_agent_session' | 'cs_agent' | 'voice_call', public.event_entity_type, nullable — Source type
  - `target_type` 'employee' | 'channel' | 'comment' | 'message' | 'tag' | 'recipient' | 'message_action' | 'api_token' | 'service_role' | 'inbox' | 'form_submission' | 'cs_agent_session' | 'cs_agent' | 'voice_call', public.event_entity_type, nullable — Target type
  - `metadata` object, nullable — Metadata of event
  - `source_employee_id` string, uuid, nullable — Source employee ID
  - `source_api_token_id` string, uuid, nullable — Source API token ID
  - `source_comment_id` string, uuid, nullable — Source comment ID
  - `source_channel_id` string, uuid, nullable — Source channel ID
  - `source_recipient_id` string, uuid, nullable — Source recipient ID
  - `target_employee_id` string, uuid, nullable — Target employee ID
  - `target_comment_id` string, uuid, nullable — Target comment ID
  - `target_message_id` string, uuid, nullable — Target message ID
  - `target_tag_id` string, uuid, nullable — Target tag ID
  - `target_message_action_id` string, uuid, nullable — Target message action ID
  - `target_inbox_id` string, uuid, nullable — Target inbox ID

## Changes

- **2026-08-14** `22a9b3b009d1` — 2 warning, 2 info
  - deleted the `query` request parameter `source_rule_id`
  - removed the optional property `items/source_rule_id` from the response with the `200` status
  - removed the `rule` enum value from the `items/source_type` response property for the response status `200`
  - removed the `rule` enum value from the `items/target_type` response property for the response status `200`

[Change history](https://skmtc.dev/getmateo/apis/mateo-api/changes/event/get.md)

---

[API](https://skmtc.dev/getmateo/apis/mateo-api.md) · [All operations](https://skmtc.dev/getmateo/apis/mateo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getmateo/mateo-api/revisions/22a9b3b009d1/schema)