Skip to main content
GET
/
api
/
v1
/
bots
/
{object_id}
/
chat_messages
Get Chat Messages
curl --request GET \
  --url https://api.example.com/api/v1/bots/{object_id}/chat_messages
{
  "next": {},
  "previous": {},
  "results": [
    {}
  ],
  "id": "<string>",
  "text": "<string>",
  "timestamp": 123,
  "timestamp_ms": "<string>",
  "to": "<string>",
  "sender_name": "<string>",
  "sender_uuid": "<string>",
  "sender_user_uuid": {},
  "additional_data": {}
}
Returns chat messages sent in the meeting. If the meeting is still in progress, this returns messages sent so far. Results are paginated using cursor pagination.

​
Authentication

Requires API key authentication via the Authorization header.

​
Path Parameters

​
object_id
string
required
Bot ID (e.g., bot_xxxxxxxxxxx)

​
Query Parameters

​
cursor
string
Cursor for pagination. Use the next value from the previous response to get the next page.
​
updated_after
string
Only return chat messages created after this time. Useful when polling for updates. Format: ISO 8601 datetime (e.g., 2024-01-18T12:34:56Z)

​
Response

​
next
string | null
URL for the next page of results, or null if no more results
​
previous
string | null
URL for the previous page of results, or null if on first page
​
results
array
Array of chat message objects

​
Chat Message Object

​
id
string
Unique identifier for the chat message
​
text
string
Content of the chat message
​
timestamp
integer
Unix timestamp of when the message was sent
​
timestamp_ms
string
Timestamp in milliseconds as a string
​
to
string
Recipient of the message (e.g., ‘everyone’, ‘specific_user’)
​
sender_name
string
Name of the message sender
​
sender_uuid
string
UUID of the message sender
​
sender_user_uuid
string | null
User UUID of the sender (platform-specific persistent identifier)
​
additional_data
object
Additional metadata about the message

​
Example Request

curl https://app.attendee.dev/api/v1/bots/bot_weIAju4OXNZkDTpZ/chat_messages \
  -H "Authorization: Token YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

​
Example with Polling

curl "https://app.attendee.dev/api/v1/bots/bot_weIAju4OXNZkDTpZ/chat_messages?updated_after=2024-01-18T12:34:56Z" \
  -H "Authorization: Token YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

​
Example with Pagination

curl "https://app.attendee.dev/api/v1/bots/bot_weIAju4OXNZkDTpZ/chat_messages?cursor=cD00ODY%3D" \
  -H "Authorization: Token YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

Build docs developers (and LLMs) love

Get started for freeTalk to us