Leads

Retrieve a lead

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

Requires leads:read. Tenant keys can only retrieve leads assigned to their organization’s campaigns; inaccessible and missing leads both return 404 not_found.

curl -G 'https://app.dialdozer.com/hooks/api_v1.php' \
  --data-urlencode 'r=leads/42' \
  -H "X-Api-Key: $DIALDOZER_API_KEY"

Path parameters

Parameter	Type	Required	Description
lead_id	integer	yes	Unique lead identifier

Response

Field	Type	Description
lead_id	integer	Unique lead identifier
first_name	string	First name
last_name	string	Last name
phone	string	Primary phone digits
email	string	Email address, when available
address1	string	Street address
city	string	City
state	string	State or region
postal_code	string	Postal code
status	string	Current dialer status
campaign	string	Campaign ID resolved through the lead’s list

{
  "ok": true,
  "lead": {
    "lead_id": 42,
    "first_name": "Alice",
    "last_name": "Johnson",
    "phone": "15551234567",
    "email": "alice@example.com",
    "address1": "100 Main St",
    "city": "Austin",
    "state": "TX",
    "postal_code": "78701",
    "status": "NEW",
    "campaign": "OUTBOUND"
  }
}