LaunchDarkly REST API
LaunchDarkly DocsSign in
HomeAPI ReferenceSDKsContext Plugin
Account usage (beta)

Rank Streaming usage by project

GET
/api/v2/usage/data-export-events/projects/ranking

Rank projects with usage in the requested range by successful Streaming transfers. Legacy rows are attributed through the account's complete current environment-to-project mapping. If any successful row remains unattributed after resolution, the operation returns 409 instead of a partial ranking. The result limit does not cap the account-wide project universe or environment mapping. This source-specific operation does not provide Combined or Warehouse ranking.

Authorization

ApiKey read, write
Authorization<token>

In: header

Scope: read, write

Query Parameters

from*integer

Inclusive UTC range start in Unix milliseconds.

Formatint64
to*integer

Exclusive UTC range end in Unix milliseconds.

Formatint64
source?string

The source scope. Only streaming is supported.

Default"streaming"
dimension?string

The ranking dimension. Only project is supported.

Default"project"
projectKey?array<string>

A canonical project key to include. Can be specified multiple times, with at most 100 unique explicit selections; duplicates do not consume the limit. When omitted, all account projects with usage in the requested range are ranked.

search?string

A case-insensitive substring matched against canonical project keys before querying usage. Project names are not searched.

cursor?string

An opaque cursor returned by a previous response. Cursors are bound to the account and ranking inputs.

limit?integer

The maximum number of ranked projects to return. This bounds response rows and look-ahead, not the account-wide candidate universe.

Range1 <= value <= 100
Default5

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/usage/data-export-events/projects/ranking?from=0&to=0"
{  "scope": {    "from": 7,    "source": "streaming",    "to": 9,    "dimension": "project"  },  "page": {    "nextCursor": "nextCursor",    "limit": 5,    "count": 5,    "totalCount": 2  },  "items": [    {      "projectKey": "projectKey",      "components": {        "streaming": 1      },      "usage": 6,      "rank": 0,      "projectName": "projectName"    },    {      "projectKey": "projectKey",      "components": {        "streaming": 1      },      "usage": 6,      "rank": 0,      "projectName": "projectName"    }  ]}

Get warehouse Data Export usage GET

Get a time series array showing the number of rows exported to your warehouse Data Export destinations. The supported granularity varies by aggregation type. The maximum time range is 365 days.

Find users GET

> ### Use contexts instead > > After you have upgraded your LaunchDarkly SDK to use contexts instead of users, you should use [Search for context instances](https://launchdarkly.com/docs/api/contexts/search-context-instances) instead of this endpoint. Search users in LaunchDarkly based on their last active date, a user attribute filter set, or a search query. An example user attribute filter set is `filter=firstName:Anna,activeTrial:false`. This matches users that have the user attribute `firstName` set to `Anna`, that also have the attribute `activeTrial` set to `false`. To paginate through results, follow the `next` link in the `_links` object. To learn more, read [Representations](https://launchdarkly.com/docs/api#representations).