v1

latestOpenAPI 3.0.3MIT2026-07-26104113247.1 KB

Segmentation

Numerically Bucket

Get data for an event, segmented and filtered by properties, with values placed into numeric buckets. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.

get/segmentation/numeric

Query parameters

project_idinteger required

Required if using service account to authenticate request.

workspace_idinteger

The id of the workspace if applicable.

eventstring required

The event that you wish to get data for. Note: this is a single event name, not an array.

from_datestring required

The date in yyyy-mm-dd format to begin querying from. This date is inclusive.

to_datestring required

The date in yyyy-mm-dd format to query to. This date is inclusive.

onstring required

The property expression to segment the event on. This expression must be a numeric property. See the expressions section below.

unit'hour' | 'day'

This can be "hour" or "day". This determines the buckets into which the property values that you segment on are placed. The default value is "day".

wherestring

An expression to filter events by. See the expression to segment below.

type'general' | 'unique' | 'average'

This can be "hour" or "day". This determines the buckets into which the property values that you segment on are placed. The default value is "day".

Response

Success

legend_sizeinteger

List of all dates.