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"
}