---
title: "Get chat messages"
method: GET
path: "/api-public/v1/chat"
tags: ["Chat"]
---

# Get chat messages

`GET /api-public/v1/chat`

Retrieve chat messages for your organization. Optionally filter by incident ID.

This API may be called a maximum of 2 times per second.

## Query parameters

- `incidentId` integer
- `limit` integer
- `offset` integer

## Headers

- `X-VO-Api-Id` string, required
- `X-VO-Api-Key` string, required

## Response `200`

A list of chat messages

- ChatMessageList — A list of chat messages
  - `messages` ChatMessage[]
    - `username` string — The username of the message author
    - `text` string — The body of the chat message
    - `serviceTime` integer — The time the message was recorded, in epoch milliseconds
    - `sequence` integer — The sequence number of the message within the timeline, used for ordering
    - `tags` string[] — Tags associated with this chat message
  - `hasMore` boolean — Whether more messages are available beyond the current page. Use the limit and offset query parameters to page through additional results.

## Other responses

- `400` — Problem with the request arguments. The response payload may include an error message.
- `401` — Authentication parameters missing
- `403` — Authentication failed or rate-limit reached
- `404` — Path not found
- `500` — Internal Server Error

---

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