Skip to content
IForevents Docs
IForevents Docs
HomeDashboardGitHubPrivacyTermsSecurityIntroduction
Support and SLA

Distinct values of one property, most frequent first

GET
/v1/analytics/properties/values

Max 100, ties broken by value. truncated is true when more values exist than were returned. Supports the $event, $type, $email, $custom_id and $name built-ins in addition to custom keys. Event values are counted over events in [start, end), by default the last 30 days and at most 90; the answer echoes the window. User values are counted over current profiles.

Authorization

AuthorizationBearer <token>

Session token issued by the accounts service (or the legacy /v1/auth routes).

In: header

Query Parameters

scope*string

Value in

  • "event"
  • "user"
property*string
event?string

For scope=event, only values seen on this event name.

q?string

Case-insensitive substring filter.

start?string

For scope=event, the window start (RFC3339). Default: end minus 30 days.

Formatdate-time
end?string

For scope=event, the window end, exclusive (RFC3339). Default: now.

Formatdate-time

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/analytics/properties/values?scope=event&property=string"
{  "end": "2026-09-13T12:30:45Z",  "start": "2026-09-03T12:00:00Z",  "truncated": false,  "values": [    "pro",    "growth"  ]}