Milestone Events API

Retrieve the history of milestone trigger firings. Each record represents a time a milestone trigger fired for a lead.

GET /milestone-events

List milestone events for the active Organizational Unit.

Request

Parameter	Type	Required	Description
page	integer	No	Page number (default: 1)
limit	integer	No	Results per page (default: 25, max: 100)
trigger_id	string	No	Filter by specific trigger

Response

200 OK

{
  "events": [
    {
      "id": "mevt-123",
      "trigger_id": "trigger-456",
      "trigger_name": "Hot Lead Alert",
      "lead_id": "ld_789",
      "score": 82,
      "event_type": "demo_request",
      "fired_at": "2025-01-15T10:35:00Z"
    }
  ],
  "total": 15,
  "page": 1,
  "limit": 25
}

Response Fields

Field	Type	Description
id	string	Unique milestone event identifier
trigger_id	string	Trigger that fired
trigger_name	string	Human-readable trigger name
lead_id	string	Lead that triggered the milestone
score	integer	Lead's score when the trigger fired
event_type	string	Event type that caused the firing
fired_at	timestamp	When the trigger fired

Example

curl -X GET "https://api.leadvibe.com/milestone-events?page=1&limit=25" \
  -H "Authorization: Bearer <token>"

Common Errors

Status	Meaning	Solution
401	Unauthorized	Check authentication token
500	Server Error	Contact support if persists

---

Notes

• Milestone events are OU-scoped to the active Organizational Unit
• Events are ordered by most recent first
• Use the trigger_id filter to focus on a specific trigger's history

Related Endpoints

• Export Milestone Events - Download as CSV
• Milestone Triggers - Manage triggers