Get Conversation History via WhatChimp API

Retrieve the full message history with any subscriber — messages sent, received, timestamps, and delivery status.

Updated 5 February 2026

Retrieve the full conversation history with any subscriber — every message sent and received, with timestamps, sender info, and delivery status.

Before you begin: Make sure you have your API key and phone number ID. See Getting Started with WhatChimp Developer API for setup instructions.

Endpoint

GET/POST /api/v1/whatsapp/get/conversation

https://app.whatchimp.com/api/v1/whatsapp/get/conversation

Parameters

Parameter	Type	Required	Description
`apiToken`	String	Yes	Your WhatChimp API key
`phone_number_id`	String	Yes	Your WhatsApp phone number ID
`phone_number`	String	Yes	Subscriber's phone number with country code (e.g., `919999999999`)
`limit`	Number	Yes	Number of messages to fetch
`offset`	Number	No	Pagination offset (start from this position)

Request Examples

GET:

https://app.whatchimp.com/api/v1/whatsapp/get/conversation?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&phone_number=919999999999&limit=10&offset=1

POST (cURL):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/get/conversation' \
  -d 'apiToken=API-KEY' \
  -d 'phone_number_id=PHONE-NUMBER-ID' \
  -d 'phone_number=919999999999' \
  -d 'limit=10' \
  -d 'offset=1'

Get Conversation endpoint showing parameters, request examples, and sample response in the API console

Response

{
  "status": "1",
  "message": [
    {
      "id": 8003,
      "sender": "bot",
      "agent_name": null,
      "message_content": "{...}",
      "conversation_time": "2024-07-28 13:21:03",
      "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
      "message_status": "delivered",
      "delivery_status_updated_at": "2024-07-28 13:21:05"
    },
    {
      "id": 8004,
      "sender": "subscriber",
      "agent_name": null,
      "message_content": "Hi, I need help with my order",
      "conversation_time": "2024-07-28 13:25:10",
      "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABIYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
      "message_status": null,
      "delivery_status_updated_at": null
    }
  ]
}

Response Fields

Field	Description
`id`	Internal message ID
`sender`	Who sent the message: `"bot"`, `"subscriber"`, or an agent name
`agent_name`	Name of the human agent (if message was sent from Live Chat)
`message_content`	The message text. For bot messages, this is a JSON string with the full message payload
`conversation_time`	Timestamp when the message was sent
`wa_message_id`	WhatsApp message ID — use this with the Delivery Status API to track delivery
`message_status`	Current delivery status (`sent`, `delivered`, `read`, `failed`)
`delivery_status_updated_at`	When the delivery status was last updated

Pagination

Use limit and offset to paginate through long conversations:

# First 10 messages
?limit=10&offset=1

# Next 10 messages
?limit=10&offset=11

# Next 10
?limit=10&offset=21

Use Cases

CRM integration — Sync conversation history into your CRM or helpdesk
Analytics — Analyze response times, message volumes, and conversation patterns
Audit trail — Keep a record of all customer interactions
Chatbot debugging — Review what your bot sent vs what the customer replied

Get Message Delivery Status via WhatChimp API — Track if a message was delivered and read
Get Bot Postback List via WhatChimp API — Retrieve all bot flow triggers
Getting Started with WhatChimp Developer API — API setup and authentication