HomeUser GuidesAPI Reference
Get Started
HomeAPI Reference
Authentication
Branches
Contact Groups
Contacts
Conversations
Error HandlingInvoices
Messages
Orders
Rate LimitingSDKs & Code ExamplesTemplatesTicketsAPI VersioningWABA NumbersWebhooks
User GuideAPI ReferenceGet Conversation MessagesGet Conversation Messages

Get Conversation Messages

View all messages of a specific conversation

Reading time: 1 minute

Get Conversation Messages

View all messages of a specific conversation.

GET{{base_url}}/conversations/{id}

Path Parameters

ParameterTypeRequiredDescription
idintegerYesConversation ID

Query Parameters

ParameterTypeRequiredDescription
phone_number_idstringYesPhone number ID of the sender

Example Request

Example Requestbash
curl -X GET "{{base_url}}/conversations/1?phone_number_id=123456" \
-H "Accept: application/json" \
-H "X-Awal-Signature-256: sha256=abc..." \
-H "X-Timestamp: 1704124800" \
-H "X-Domain: your-workspace" \
-H "X-Client-ID: your-client-id"

Example Response

Response200 OK
{
"status": true,
"data": {
  "id": 1,
  "phone": "96650000000",
  "name": "Ahmed Mohammed",
  "status": "opened",
  "messages": [
    {
      "id": 1,
      "content": "Hello",
      "type": "text",
      "direction": "inbound",
      "date": "2024-01-20T10:30:00Z",
      "status": "read"
    },
    {
      "id": 2,
      "content": "Welcome! How can I help you?",
      "type": "text",
      "direction": "outbound",
      "date": "2024-01-20T10:31:00Z",
      "status": "delivered"
    }
  ],
  "meta": {
    "total_messages": 2
  }
}
}

Related

← Back to Conversations
View Guide
View