Sequence Events API

Retrieve the history of sequence trigger firings. Each record represents a time a lead completed a sequence of events that matched a sequence trigger.

GET /sequence-events

List sequence 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)
sequence_id	string	No	Filter by specific sequence trigger

Response

200 OK

{
  "events": [
    {
      "id": "sevt-123",
      "sequence_id": "seq-456",
      "sequence_name": "Buying Intent Sequence",
      "lead_id": "ld_789",
      "event_types": ["pricing_page_view", "whitepaper_download", "demo_request"],
      "fired_at": "2025-01-15T11:00:00Z"
    }
  ],
  "total": 8,
  "page": 1,
  "limit": 25
}

Response Fields

Field	Type	Description
id	string	Unique sequence event identifier
sequence_id	string	Sequence trigger that fired
sequence_name	string	Human-readable sequence trigger name
lead_id	string	Lead who completed the sequence
event_types	array	The event types that were completed
fired_at	timestamp	When the sequence was completed

Example

curl -X GET "https://api.leadvibe.com/sequence-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

• Sequence events are OU-scoped to the active Organizational Unit
• Events are ordered by most recent first

Related Endpoints

• Export Sequence Events - Download as CSV
• Sequence Triggers - Manage sequence triggers