Skip to main content
GET
Rank Streaming usage by project

Authorizations

Authorization
string
header
required

Query Parameters

from
integer<int64>
required

Inclusive UTC range start in Unix milliseconds.

to
integer<int64>
required

Exclusive UTC range end in Unix milliseconds.

source
string
default:streaming

The source scope. Only streaming is supported.

dimension
string
default:project

The ranking dimension. Only project is supported.

projectKey
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.

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
default:5

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

Required range: 1 <= x <= 100

Response

Bounded project ranking

A bounded Streaming project ranking.

items
object[]
required

Projects in deterministic rank order.

page
object
required
Example:
scope
object
required
Example: