Lead Histories

Lead histories track status changes for leads over time.

REST API Endpoints

List Lead Histories

GET/api/web/1.0/lead-histories🔒 Bearer Token

Retrieve a paginated list of lead status change history.

Query Parameters:

Parameter	Type	Required	Description
per_page	number	No	Results per page

Example Request:

curl -X GET "https://your-domain.com/api/web/1.0/lead-histories?per_page=50" \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

Example Response (200):

{
  "data": [
    {
      "lead_reference": "LD-00001",
      "old_status": "new",
      "new_status": "confirmed",
      "changed_by": "Agent Name",
      "changed_at": "2025-01-15T14:30:00Z"
    }
  ],
  "meta": { "current_page": 1, "per_page": 50, "total": 230 }
}

Dashboard Endpoints

List Lead Histories

GET/lead-histories🔒 Session

Paginated list of lead history entries in the dashboard.

Show Lead History

GET/lead-histories/{lead}/show🔒 Session

View the full status change history for a specific lead.