---
title: "List Conversation log for Ticket"
method: GET
path: "/api/v2/tickets/{ticket_id}/conversation_log"
tags: ["Conversation Log"]
---

# List Conversation log for Ticket

`GET /api/v2/tickets/{ticket_id}/conversation_log`

Lists the conversation log events for a specified ticket.

#### Pagination

- Cursor pagination (recommended)
- Offset pagination

See [Pagination](/api-reference/introduction/pagination/).

Returns a maximum of 100 records per page.

#### Allowed for

* Agents

## Path parameters

- `ticket_id` integer, required

## Query parameters

- `page[before]` string
- `page[after]` string
- `page[size]` integer

## Response `200`

Successful response

- ConversationLogResponse
  - `events` ConversationLogObject[]
    - `attachments` AttachmentObject[], required — A collection of attachments (image or file) associated with the event
      - `content_type` string — The content type of the image. Example value: "image/png"
      - `content_url` string — A full URL where the attachment image file can be downloaded. The file may be hosted externally so take care not to inadvertently send Zendesk authentication credentials. See [Working with url properties](/documentation/ticketing/managing-tickets/working-with-url-properties)
      - `deleted` boolean — If true, the attachment has been deleted
      - `file_name` string — The name of the image file
      - `height` integer — The height of the image file in pixels. If height is unknown, returns null
      - `id` integer — Automatically assigned when created
      - `inline` boolean — If true, the attachment is excluded from the attachment list and the attachment's URL can be referenced within the comment of a ticket. Default is false
      - `malware_access_override` boolean — If true, you can download an attachment flagged as malware. If false, you can't download such an attachment.
      - `malware_scan_result` string — The result of the malware scan. There is a delay between the time the attachment is uploaded and when the malware scan is completed. Usually the scan is done within a few seconds, but high load conditions can delay the scan results. Possible values: "malware_found", "malware_not_found", "failed_to_scan", "not_scanned"
      - `mapped_content_url` string — The URL the attachment image file has been mapped to
      - `size` integer — The size of the image file in bytes
      - `url` string — A URL to access the attachment details
      - `width` integer — The width of the image file in pixels. If width is unknown, returns null
      - `thumbnails` AttachmentBaseObject[] — An array of attachment objects. Note that photo thumbnails do not have thumbnails
        - `content_type` string — The content type of the image. Example value: "image/png"
        - `content_url` string — A full URL where the attachment image file can be downloaded. The file may be hosted externally so take care not to inadvertently send Zendesk authentication credentials. See [Working with url properties](/documentation/ticketing/managing-tickets/working-with-url-properties)
        - `deleted` boolean — If true, the attachment has been deleted
        - `file_name` string — The name of the image file
        - `height` integer — The height of the image file in pixels. If height is unknown, returns null
        - `id` integer — Automatically assigned when created
        - `inline` boolean — If true, the attachment is excluded from the attachment list and the attachment's URL can be referenced within the comment of a ticket. Default is false
        - `malware_access_override` boolean — If true, you can download an attachment flagged as malware. If false, you can't download such an attachment.
        - `malware_scan_result` string — The result of the malware scan. There is a delay between the time the attachment is uploaded and when the malware scan is completed. Usually the scan is done within a few seconds, but high load conditions can delay the scan results. Possible values: "malware_found", "malware_not_found", "failed_to_scan", "not_scanned"
        - `mapped_content_url` string — The URL the attachment image file has been mapped to
        - `size` integer — The size of the image file in bytes
        - `url` string — A URL to access the attachment details
        - `width` integer — The width of the image file in pixels. If width is unknown, returns null
    - `author` object, required — Object that describes the user who created the event
      - `type` 'user' | 'agent' | 'bot' — Either user, agent, or bot
      - `zen:sunco:user_id` string — A Zendesk resource name prefix describing a messaging user
      - `zen:support:user_id` integer — A Zendesk resource name prefix describing a Support user
    - `content` object, required — Object that describes the content of the message. The inner fields depends on the record type
    - `created_at` string, date-time, required — The timestamp of when this record was created
    - `id` string, required — Unique record identifier
    - `metadata` object, required — Various additional data that further describes this record
    - `reference` string, required — A Zendesk resource name value that uniquely identifies this record. Example: `zen:ticket_event:<id>`
    - `type` string, required — The type of record, representing one of the conversational ticket events. Examples: `Comment` or `Messaging::ConversationMessage`
  - `links` object
    - `next` string
    - `prev` string
  - `meta` object
    - `after_cursor` string
    - `before_cursor` string
    - `has_more` boolean

## Changes

> 29 revisions in range; 1 not diffed.

- **2025-06-13** `4085d8c72c5c` — 4 breaking
  - the `events/items/attachments/items/allOf[#/components/schemas/AttachmentBaseObject]/height` response's property type/format changed from `string`/`` to `integer`/`` for status `200`
  - the `events/items/attachments/items/allOf[#/components/schemas/AttachmentBaseObject]/width` response's property type/format changed from `string`/`` to `integer`/`` for status `200`
  - the `events/items/attachments/items/allOf[#/components/schemas/AttachmentThumbnails]/thumbnails/items/height` response's property type/format changed from `string`/`` to `integer`/`` for status `200`
  - the `events/items/attachments/items/allOf[#/components/schemas/AttachmentThumbnails]/thumbnails/items/width` response's property type/format changed from `string`/`` to `integer`/`` for status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/botbrains-io/apis/support-api/changes/api/v2/tickets/:ticket_id/conversation_log/get.md)

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)