Chat History

Returns messages exchanged with a single contact, newest first. Identify the contact by either phone (must already exist in your contact directory) or contactId. Cursor-paginated via before + nextCursor.

GET/v2.0/chats/history

Query Parameters

Query

Parameter	Type	Required	Description
phone	string	Optional	Recipient phone in international format. Either this or contactId
contactId	string	Optional	Sendiee Contact id. Either this or phone
defaultCountryCode	string	Optional	Used with phone if it's a local number
limit	number	Optional	1–100. Default 20
before	string (ISO 8601)	Optional	Cursor — return messages older than this timestamp. Use the previous response's nextCursor
brandNumber	string	Optional	Only return messages exchanged with this business number (for organizations with several WhatsApp numbers)
excludeInternal	boolean	Optional	true hides inbox-only notes (lead-categorization summaries, operator memory notes, assignment summaries) that were never sent to the customer. Default false

Phone must exist as a contact

Sendiee requires a Contact record before returning chat history (so we can scope the query strictly to your org). If the phone is unknown the response is 404 CONTACT_NOT_FOUND — call Create / Update Contact first if needed.

Example

curl -X GET "https://api.sendiee.com/v2.0/chats/history?phone=919876543210&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "data": [
    {
      "messageId": "664a...",
      "wamid": "wamid.HBg...",
      "direction": "outbound",
      "origin": "campaign",
      "internal": false,
      "status": "delivered",
      "type": "template",
      "text": null,
      "media": null,
      "components": {},
      "reactions": {
        "user": null,
        "brand": null
      },
      "campaignId": "664c...",
      "cost": {
        "amount": 0.83,
        "currency": "INR",
        "category": "marketing"
      },
      "createdAt": "2026-04-29T05:18:42.000Z"
    },
    {
      "messageId": "664b...",
      "wamid": "wamid.HBh...",
      "direction": "inbound",
      "origin": null,
      "internal": false,
      "status": "received",
      "type": "text",
      "text": "Thanks!",
      "media": null,
      "components": null,
      "reactions": {
        "user": null,
        "brand": null
      },
      "campaignId": null,
      "cost": null,
      "createdAt": "2026-04-29T05:18:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "hasMore": true,
    "nextCursor": "2026-04-29T05:18:00.000Z"
  },
  "contact": {
    "phone": "919876543210",
    "window": {
      "open": true,
      "lastInboundAt": "2026-04-29T05:18:00.000Z",
      "closesAt": "2026-04-30T05:18:00.000Z"
    }
  }
}