Get a time series array showing the number of data export events from your account. The supported granularity varies by aggregation type. The maximum time range is 365 days. `groupBy=projectId` resolves legacy rows through the account's current environment-to-project mapping and returns `409` instead of a partial series when any successful row remains unattributed. Plain project filtering keeps its current-environment compatibility behavior.
Query parameters
fromstringOptionalformat: "string"
The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
tostringOptionalformat: "string"
The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
projectKeystringOptionalformat: "string"
A project key to filter results by. Without groupBy=projectId, filters to the project’s current environments so retained pre-materialization usage remains visible. Can be specified multiple times, one query parameter per project key.
environmentKeystringOptionalformat: "string"
An environment key to filter results by. If specified, exactly one projectKey must be provided. Can be specified multiple times, one query parameter per environment key.
eventKindstringOptionalformat: "string"
An event kind to filter results by. Can be specified multiple times, one query parameter per event kind.
destinationKindstringOptionalformat: "string"
A Streaming configuration kind to filter results by. Values preserve raw product identity; `snowflake` is legacy Streaming Snowflake and is distinct from Warehouse `snowflake-v2`. Can be specified multiple times.<br/>Valid values: `kinesis`, `google-pubsub`, `mparticle`, `segment`, `azure-event-hubs`, `snowflake`, `unknown`.
groupBystringOptionalformat: "string"
If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension. `projectId` requires one or more explicit `projectKey` filters and is capped at 100 selected projects.<br/>Valid values: `projectId`, `environmentId`, `eventKind`, `destinationKind`.
aggregationTypestringOptionalformat: "string"
Specifies the aggregation method. Defaults to month_to_date.
Valid values: month_to_date, incremental.
granularitystringOptionalformat: "string"
Specifies the data granularity. Defaults to daily. monthly granularity is only supported with the month_to_date aggregation type.
Valid values: daily, hourly, monthly.
Response
Usage response
_linksmap from strings to any
The location and content type of related resources
metadatalist of maps from strings to any
Metadata about each series
serieslist of maps from strings to integers
An array of data points with timestamps. Each element of the array is an object with a ‘time’ field, whose value is the timestamp, and one or more key fields. If there are multiple key fields, they are labeled ‘0’, ‘1’, and so on, and are explained in the metadata.
