seline-logo
Public API
Overview
MCP

Visitor events

Get all events for a specific visitor. Use this after finding a visitor (via the visitor, visitors, or most active visitors endpoint) to analyze their behavior over time.

POST
https://api.seline.com/api/v1/visitor-events
Click anywhere to copy

Parameters

visitorId
stringRequired
Visitor's internal id (UUID). You can find it in the response of the visitor, visitors, or most active visitors endpoints.
period
stringRequired if no range is provided
Predefined time period today, 1h, 24h, 7d, 30d, 6m, 12m, all_time, month_to_date, week_to_date, year_to_date. Either period or range is required.
range
objectRequired if no period is provided
Custom date range object with from and to ISO 8601 datetime strings, e.g. 2025-09-10T00:00:00Z, both required.

Example - { from: "2025-09-10T00:00:00Z", to: "2025-09-11T00:00:00Z" }
page
number
Page number for pagination
perPage
number
Number of items per page. Default is 1000. Maximum is 1000.
Example request
curl -X POST 'https://api.seline.com/api/v1/visitor-events' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "visitorId": "a3f0e8e2-12b4-4f0c-86ad-ed1f4f0ee1b8",
    "range": {
      "from": "2025-06-10T00:00:00Z",
      "to": "2025-09-10T00:00:00Z"
    },
    "page": 1,
    "perPage": 1000
  }'
Click anywhere to copy
Response
{
  "events": [
    {
      "type": "page-view",
      "pathname": "/pricing",
      "date": "2025-09-09 13:02:48",
      "country": "US",
      "device": "desktop",
      "browser": "Chrome"
    },
    {
      "type": "custom",
      "name": "user: signed up",
      "date": "2025-09-09 13:04:11",
      "data": "{\"plan\":\"pro\"}"
    }
  ]
}
Click anywhere to copy