List chat messages

GET

https://api.hmsovereign.com/api/v1/chats

Chats

Last modified:2026-04-23 10:43:17

Maintainer:Not configured

List chat messages for a contact, newest first. Use this for dashboards or manual inspection; use /chats/context when feeding history to an LLM or voice agent.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

List of messages, newest first

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.hmsovereign.com/api/v1/chats?contact_id&channel&agent_id&limit&offset' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "messages": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
            "contact_id": "+31612345678",
            "channel": "whatsapp",
            "role": "user",
            "content": "string",
            "metadata": {
                "provider_message_id": "wamid.ABC",
                "attachments": []
            },
            "created_at": "2019-08-24T14:15:22.123Z"
        }
    ],
    "pagination": {
        "total": 42,
        "limit": 100,
        "offset": 0
    }
}

Modified at 2026-04-23 10:43:17

Append a chat message

Delete a chat message