seline-logo
Public API
Overview
Endpoints
Data over time
Visits and pageviews
Charges
Counts and totals
Stats
Metrics
Custom events
Ingest data
Events

Custom Events

Retrieve custom events and charge events with pagination and search.

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

Parameters

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" }
types
array
Filter by event types custom, charge. Default is both. charge is a type of event that happens if you use revenue tracking or Stripe integration.
filters
object
Optional filters to narrow down data page, entryPage, exitPage, country, region, city, browser, device, referrer, campaign, source, medium, content, term, event, hostname, os, tag.

Should be a string in a operator:value;operator:value;... format. Operators are is, is not, contains, does not contain.

Example page filter - "is:/support;is:/community;is not:/publishing"
search
string
Search term to filter results. Case-insensitive.
page
number
Page number for pagination
limit
number
Number of results per page. Default is 10. Maximum is 1000.
Example request
curl -X POST "https://api.seline.com/api/v1/custom-events" -H "Authorization: Bearer API_TOKEN" -H "Content-Type: application/json" -d '{
  "range": {
    "from": "2025-06-10T00:00:00Z",
    "to": "2025-09-10T00:00:00Z"
  },
  "types": ["charge"],
  "filters": {
    "country": "is:US"
  }
}'
Click anywhere to copy
Response
{
  "data": [
    {
        "name": "project: created",
        "count": 144
    },
    ...
    {
        "name": "user: signed up",
        "count": 110
    },
  ],
  // total number of different events during the specified time range
  "total": 14,
}
Click anywhere to copy