Skip to main content
Get the chat message history for a specific meeting room. Returns all messages sent during the meeting.

Endpoint

GET /rooms/:id/messages

Authentication

No authentication required. Any user with the room ID can retrieve messages.
Messages are only persisted during the meeting session. Once a room is ended, message history may be cleared depending on server configuration.

Path Parameters

id
string
required
The room’s unique identifier (CUID)

Response

Returns an array of message objects ordered by creation time (oldest first).
messages
array
Array of chat message objects

Example Request

cURL
curl -X GET https://api.neuronmeet.com/rooms/clh3x2k5g0001l408xyz12345/messages

Example Response

[
  {
    "id": "clh3x7k5g0006l408xyz44444",
    "roomId": "clh3x2k5g0001l408xyz12345",
    "userId": "clh3x2k5g0001l408xyz12345",
    "senderName": "Alex J.",
    "content": "Welcome everyone to the meeting!",
    "type": "TEXT",
    "createdAt": "2024-03-03T10:01:00.000Z",
    "user": {
      "name": "Alex Johnson",
      "displayName": "Alex J."
    }
  },
  {
    "id": "clh3x8k5g0007l408xyz55555",
    "roomId": "clh3x2k5g0001l408xyz12345",
    "userId": null,
    "senderName": "Guest User",
    "content": "Thanks for having me!",
    "type": "TEXT",
    "createdAt": "2024-03-03T10:02:30.000Z",
    "user": null
  },
  {
    "id": "clh3x9k5g0008l408xyz66666",
    "roomId": "clh3x2k5g0001l408xyz12345",
    "userId": null,
    "senderName": "System",
    "content": "Sarah W. joined the meeting",
    "type": "SYSTEM",
    "createdAt": "2024-03-03T10:10:00.000Z",
    "user": null
  }
]

Message Types

Standard text messages sent by participants during the meeting.
{
  "type": "TEXT",
  "senderName": "Alex J.",
  "content": "Hello everyone!"
}
Automated messages about meeting events (join, leave, settings changes).
{
  "type": "SYSTEM",
  "senderName": "System",
  "content": "Meeting locked by host"
}
Messages related to file sharing (if implemented).
{
  "type": "FILE",
  "senderName": "Alex J.",
  "content": "presentation.pdf"
}

Error Responses

404 Not Found

Room does not exist.
{
  "statusCode": 404,
  "message": "Room not found"
}

Use Cases

  • Load chat history when joining a meeting late
  • Export meeting chat transcript
  • Review messages after meeting ends
  • Search through meeting discussions
  • Compliance and record-keeping

Real-Time Updates

For real-time chat during meetings, use WebSocket events instead of polling this endpoint:
  • chat-message - New message received
  • user-typing - User is typing indicator
See Chat Events for real-time chat implementation.
When a user joins a room via WebSocket, the last 50 messages are automatically sent in the room-joined event. Use this endpoint only if you need the complete history or are joining via REST API.

Build docs developers (and LLMs) love