API Reference / Events
Events
An event is a single captured conversion. Events are written by the loader when a flow fires, then delivered to your destinations. This resource is read-only, newest first.
The event object
id
string
Prefixed identifier, e.g. evt_ab2c182b…. Guaranteed.
site_key
string
The site's public key (matches a site's site_key). Guaranteed.
occurred_at
timestamp | null
When the conversion fired in the browser. Guaranteed.
flow_name
string
The flow that produced the event. Passed through.
trigger
string
What fired it, e.g. form_submission. Passed through.
status
string
Delivery status: completed, failed, or queued. Passed through.
actions
array
Per-destination delivery results. Passed through.
Endpoints
GET/v1/events
curl "https://app.converly.io/api/v1/events?site_id=site_29Et…" \ -H "Authorization: Bearer sk_live_…"
200 OK
{
"data": [
{
"id": "evt_ab2c182b…",
"site_key": "site_1VQH84sr",
"occurred_at": "2026-06-30T12:04:11.412Z",
"flow_name": "Demo bookings",
"trigger": "form_submission",
"status": "completed"
}
],
"has_more": true,
"next_cursor": "2026-06-30T12:04:11.412Z"
}