Events

Send and retrieve tracking events.

Send Event

POST /v1/events

Send a tracking event to ListenLayer.

Request Body

{
  "event": "purchase",
  "properties": {
    "transaction_id": "txn_123",
    "value": 99.99,
    "currency": "USD"
  },
  "user_id": "user_456",
  "timestamp": "2024-01-15T10:30:00Z"
}

Response

{
  "success": true,
  "data": {
    "event_id": "evt_abc123"
  }
}

List Events

GET /v1/events

Retrieve a list of events.

Query Parameters

Parameter	Type	Description
start_date	string	Start date (ISO 8601)
end_date	string	End date (ISO 8601)
event	string	Filter by event name
user_id	string	Filter by user
limit	integer	Max results (default: 100)
offset	integer	Pagination offset

Response

{
  "success": true,
  "data": [
    {
      "event_id": "evt_abc123",
      "event": "purchase",
      "properties": { ... },
      "timestamp": "2024-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "total": 1500,
    "limit": 100,
    "offset": 0
  }
}