Skip to content
KnockDevelopers
Chats

Get chat messages

Chat with a Developer
GET
/v1/chats/{contactId}/messages

Returns the messages of one chat, oldest first, up to 500.

Authorization

ApiKeyAuth
headerx-api-key<token>

Your Knock API key. Ask your Knock account team for one: a key with the Enrichment API role for enrichment, or the Viewer role for chats and meetings.

Path Parameters

contactId*string

The contactId of a chat from GET /v1/chats.

Formatuuid

Response Body

The messages of the chat.

application/json
  1. response

The messages of a chat.

messages*array<>

Messages, oldest first. At most 500: a longer chat returns its first 500.

Example Request
curl -X GET 'https://app.knock-ai.com/v1/chats/9b1e4c2a-6f3d-4e8b-a7c5-1d2e3f4a5b6c/messages' \  -H 'x-api-key: <YOUR_API_KEY>'
Example Response
{  "messages": [    {      "author": "rep",      "memberId": "5a7c9e1b-3d5f-4a6b-8c9d-0e1f2a3b4c5d",      "memberName": "Alex Kim",      "text": "Sure, does Tuesday at 3pm work?",      "sentAt": "2026-10-19T10:00:00.000Z"    }  ]}