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.

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.

Authentication

Authorizationstring

API Key authentication via header

Query parameters

fromlongRequired

Inclusive UTC range start in Unix milliseconds.

tolongRequired

Exclusive UTC range end in Unix milliseconds.

sourcestringOptionalDefaults to streaming

The source scope. Only streaming is supported.

dimensionstringOptionalDefaults to project

The ranking dimension. Only project is supported.

projectKeylist of stringsOptional

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.

searchstringOptional

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

cursorstringOptional

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

limitintegerOptional1-100Defaults to 5

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

Response

Bounded project ranking

itemslist of objects

Projects in deterministic rank order.

pageobject

scopeobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error