WAHooks
API ReferenceConnections

List Chats

Retrieve recent WhatsApp chats for a connection.

GET /api/connections/{id}/chats

Returns the most recent WhatsApp chats (up to 20) for the specified connection. The connection must be in online status for this endpoint to return results.

Authentication

HeaderTypeRequiredDescription
AuthorizationstringYesBearer token. Format: Bearer <token>

Path Parameters

ParameterTypeRequiredDescription
idstringYesThe unique identifier of the connection.

Response

200 OK
[
  {
    "id": "1234567890@c.us",
    "name": "John Doe",
    "conversationTimestamp": 1710410700
  },
  {
    "id": "0987654321@c.us",
    "name": "Jane Smith",
    "conversationTimestamp": 1710407100
  },
  {
    "id": "1122334455-group@g.us",
    "name": "Team Chat",
    "conversationTimestamp": 1710403500
  }
]
401 Unauthorized
{
  "statusCode": 401,
  "message": "Unauthorized"
}
404 Not Found
{
  "statusCode": 404,
  "message": "Connection not found"
}

On this page