API Reference
Log In
API Reference

Get revenue by organization

Returns the revenue billed to each customer organization over the whole window, with no time buckets, taken from billed line items. Amounts are summed as billed, with no currency conversion. group chooses TOTAL (the sum of line-item charges, the default) or the MEAN, MEDIAN, MAXIMUM or MINIMUM single charge. Pass organizations to return only the listed organizations; omit it to list every organization with usage in the window.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

ID of the team that owns this data.

string
enum

Predefined time window to aggregate results (e.g., TWELVE_MONTHS). Ignored if both startDate and endDate are provided. Defaults to TWELVE_MONTHS when no custom date range is specified.

string

Start of a custom date range in ISO 8601 format (e.g., 2025-09-01T00:00:00Z). Must be provided together with endDate. When both are provided, the period parameter is ignored and this custom range is used instead.

string

End of a custom date range in ISO 8601 format (e.g., 2025-09-30T23:59:59Z). Must be provided together with startDate. When both are provided, the period parameter is ignored and this custom range is used instead.

string
enum

Aggregation group for the metric.

Allowed:
organizations
array of strings

Optional list of organization identifiers to include. Omit to include all organizations with usage in the window.

organizations
products
array of strings
deprecated

Deprecated: use organizations. Takes organization identifiers and is ignored when organizations has at least one non-blank value; an empty or all-blank organizations value falls back to products.

products
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*