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

# /chat/{id}/events

`GET /chat/{id}/events`

## Request

- Base URL: `<<api-url>>` (relative, and the document’s source URL is not known)
- URL: `<<api-url>>/chat/{id}/events`
- Auth: API key in header `X-API-KEY`

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: Person that responsible for the event
    - `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: Person phone number
      - `number` string, required: Phone Number that will receive the message
      - `countryCode` string: Country code
    - `customFields` CustomFields: Custom fields
      - `key` string, required: Key of the field
      - `value` union, required: Value of the field
        - string
        - number
        - boolean
    - `organization` Organization: This field refers to the organization to which the contact belongs
      - `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.dev/octadesk/apis/octadesk-api.md) - [All operations](https://skmtc.dev/octadesk/apis/octadesk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/octadesk/apis/octadesk-api/revisions/cf3224b37a34?raw)
