Skip to content
DialDozer DialDozer Docs

Conversations

Retrieve a conversation

Section titled “Retrieve a conversation”

GET /hooks/api_v1.php?r=conversations/{lead_id}

Requires conversations:read. The response combines a compact lead header with chronological entries returned by the communication thread service.

Terminal window
curl -G 'https://app.dialdozer.com/hooks/api_v1.php' \
  --data-urlencode 'r=conversations/42' \
  -H "X-Api-Key: $DIALDOZER_API_KEY"
{
  "ok": true,
  "lead": {
    "lead_id": 42,
    "name": "Alice Johnson",
    "phone": "15551234567",
    "status": "NEW"
  },
  "entries": [
    {
      "channel": "sms",
      "direction": "outbound",
      "body": "Your appointment is confirmed."
    }
  ]
}

Entry fields can vary by channel. Consumers should tolerate new fields and unknown entry types. Render user-generated message bodies as untrusted text.