Skip to main content
GET
Get warehouse Data Export usage

Authorizations

Authorization
string
header
required

Query Parameters

from
string<string>

The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.

to
string<string>

The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.

projectKey
string<string>

A project key to filter results by. Can be specified multiple times, one query parameter per project key.

environmentKey
string<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.

destinationKind
string<string>

A Warehouse configuration kind to filter results by. Cannot be combined with destination. Can be specified multiple times.
Valid values: snowflake-v2, databricks, bigquery, redshift, clickhouse, s3.

destination
string<string>

A Warehouse configuration kind to filter results by. Cannot be combined with destinationKind. Existing behavior is unchanged. Can be specified multiple times.
Valid values: snowflake-v2, databricks, bigquery, redshift, clickhouse.

groupBy
string<string>

If specified, returns data for each distinct value of the given field. Can be specified multiple times.
Valid values: projectId, environmentId, destination, destinationKind, destinationId. destination and destinationKind return the same raw Warehouse configuration kinds. destinationId returns one series per warehouse destination with destinationName metadata. When a current destination you can view matches, its destinationId is the LaunchDarkly destination ID, with destinationViewable. Otherwise, it is the warehouse provider's destination ID, named Unknown destination. The destination's own kind is added as destinationKind only when you can view the destination. A kind requested with groupBy=destinationKind is returned unchanged. Destinations you cannot view are reported together in one Unknown destination series with destinationId hidden and destinationViewable false, one per combination of the other requested dimensions, such as destinationKind. Usage without a destination ID is one series with an empty destinationId named Unattributed.

aggregationType
string<string>

Specifies the aggregation method. Defaults to month_to_date.
Valid values: month_to_date, incremental.

granularity
string<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

The location and content type of related resources

metadata
object[]
required

Metadata about each series

series
object[]
required

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.

Example:
dataThrough
string

The end of the latest hour written by this source's usage pipeline, as an RFC 3339 UTC timestamp. It is measured across all accounts, not only yours, and usage after this time is not counted yet. Omitted when the watermark is unavailable.

Example:

"2026-09-30T15:00:00Z"

delayed
boolean

Whether this source's usage pipeline is late: it wrote every hour of the 24 hours ending at dataThrough, and more than three hours have passed since dataThrough. Always false for a source with gaps in those 24 hours, where gaps usually mean no usage rather than a stalled pipeline. Omitted when dataThrough is omitted.

Example:

false