---
title: "/chat/{id}/events"
method: GET
path: "/chat/{id}/events"
tags: ["Chat"]
---

# /chat/{id}/events

`GET /chat/{id}/events`

Retrives events from a specific chat

## Path parameters

- `id` string, required

## Headers

- `octa-agent-email` string

## Response `201`

- Event[]
  - `type` 'agent' | 'group' | 'status' | 'closed' | 'leave' | 'ticket' | 'transfer' | 'woz.assign', required — Type of event that occurred
  - `time` string, date-time, required — Date of the event
  - `user` User
    - `id` string, required — Person identifier
    - `name` string, required — Person name
    - `email` string, required — Person email
    - `type` string — Person type, if is an agent or a contact
    - `phoneContacts` PhoneContacts
      - `number` string, required — Phone Number that will receive the message
      - `countryCode` string — Country code
    - `customFields` CustomFields
      - `key` string, required — Key of the field
      - `value` union, required — Value of the field
        - string
        - number
        - boolean
    - `organization` Organization
      - `id` string, required — Organization ID
      - `name` string, required — Organization name
      - `customField` CustomFields[], required — Organization custom fields
        - `key` string, required — Key of the field
        - `value` union, required — Value of the field
          - string
          - number
          - boolean
  - `data` object — Informations about the event

---

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