WhatsApp agentsWhatsApp leads

List conversations

Returns conversations (leads), most recent activity first.

GET/v2/whatsapp/conversations

To sync, store the newest updated_at you've seen and pass it as updated_since on the next call -- you'll only get conversations that changed.

Authorization

Authorizationstringheaderrequired
Bearer authentication header of the form Bearer <api_key>, where <api_key> is a key from Account Settings → API keys in your dashboard.

Query parameters

limitinteger
Maximum items to return (1-200).
Default: 50
offsetinteger
Items to skip, for paging.
Default: 0
searchstring
Match the customer's number or name.
categorystring
A lead category, e.g. hot, or uncategorized for undecided leads.
updated_sincestring (date-time)
Only conversations changed after this time (ISO 8601).

Response

An array of conversation objects. Each item is described in the conversation object.

Request

curl --request GET \
  --url 'https://api.tarangnow.com/v2/whatsapp/conversations?category=hot&limit=50' \
  --header 'Authorization: Bearer <api_key>'

Response

[
  {
    "id": "d2c3b4a5-9687-4f1e-8d2c-3b4a59687f1e",
    "tenant_id": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",
    "whatsapp_account_id": "a9b8c7d6-e5f4-4a3b-9c2d-1e0f9a8b7c6d",
    "phone_number_id": "109876543210987",
    "customer_number": "919876543210",
    "customer_name": "Vikram",
    "agent_id": "3f6c2b1e-8a4d-4c5e-9b2a-1d7e6f8a9b0c",
    "last_message_at": "2026-10-24T14:03:11.508Z",
    "last_message_preview": "Can you share the documents list?",
    "last_message_direction": "inbound",
    "unread_count": 1,
    "ai_paused": false,
    "last_inbound_at": "2026-10-24T14:03:11.508Z",
    "opted_out_at": null,
    "category": "hot",
    "followup_step": 0,
    "trigger_delay_minutes": 10,
    "categorized_at": "2026-10-24T14:03:11.508Z",
    "status": "open",
    "created_at": "2026-10-20T09:15:42.120Z",
    "updated_at": "2026-10-24T14:03:11.508Z"
  }
]

Query parameters

limitinteger

Maximum items to return (1-200).

Default: 50

offsetinteger

Items to skip, for paging.

Default: 0

searchstring

Match the customer's number or name.

categorystring

A lead category, e.g. hot, or uncategorized for undecided leads.

updated_sincestring (date-time)

Only conversations changed after this time (ISO 8601).

[ { "id": "d2c3b4a5-9687-4f1e-8d2c-3b4a59687f1e", "tenant_id": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d", "whatsapp_account_id": "a9b8c7d6-e5f4-4a3b-9c2d-1e0f9a8b7c6d", "phone_number_id": "109876543210987", "customer_number": "919876543210", "customer_name": "Vikram", "agent_id": "3f6c2b1e-8a4d-4c5e-9b2a-1d7e6f8a9b0c", "last_message_at": "2026-10-24T14:03:11.508Z", "last_message_preview": "Can you share the documents list?", "last_message_direction": "inbound", "unread_count": 1, "ai_paused": false, "last_inbound_at": "2026-10-24T14:03:11.508Z", "opted_out_at": null, "category": "hot", "followup_step": 0, "trigger_delay_minutes": 10, "categorized_at": "2026-10-24T14:03:11.508Z", "status": "open", "created_at": "2026-10-20T09:15:42.120Z", "updated_at": "2026-10-24T14:03:11.508Z" } ]