List Billable Metrics

GET https://api.suger.cloud/org/{orgId}/billableMetric

list billable metrics for the given organization.

Parameters

Name	In	Type	Required	Description
`orgId`	path	string	yes	Organization ID
`status`	query	string	no	Status of the billable metric

Responses

200 — OK

Content-Type: application/json

BillableMetric fields:

Field	Type	Required
`aggregationType`	BillableMetricAggregationType	no
`creationTime`	string	no
`description`	string	no
`id`	string	no
`info`	BillableMetricInfo	no
`lastUpdateTime`	string	no
`name`	string	no
`organizationId`	string	no
`status`	BillableMetricStatus	no

BillableMetricInfo fields:

Field	Type	Required	Description
`filterGroups`	array<BillableMetricFilterGroup>	no	FilterGroups is a list of filter groups. The filterGroups are connected by AND.
`groupBys`	array<string>	no	GroupBys is a list of fields to group by.
`propertyUniqueOn`	string	no	The target property for unique count aggregate.

BillableMetricFilterGroup fields:

Field	Type	Required	Description
`filters`	array<BillableMetricFilter>	no

BillableMetricFilter fields:

Field	Type	Required	Description
`name`	string	no
`operation`	BillableMetricFilterOperation	no
`value`	object	no	The value of the filter. The type of the value depends on the valueType.
`valueType`	BillableMetricFilterValueType	no

400 — Bad request error

Content-Type: application/json

500 — Internal server error

Content-Type: application/json

Example

Generated from this operation's schema. Values are placeholders — substitute your own ids, and set SUGER_TOKEN to a bearer token from the OAuth client-credentials exchange.

Request

curl -X GET 'https://api.suger.cloud/org/{orgId}/billableMetric' \
  -H "Authorization: Bearer $SUGER_TOKEN"

Response — 200

[
  {
    "aggregationType": "COUNT",
    "creationTime": "2026-01-31T12:00:00Z",
    "description": "string",
    "id": "01H0000000000000000000",
    "info": {
      "filterGroups": [
        {
          "filters": []
        }
      ],
      "groupBys": [
        "string"
      ],
      "propertyUniqueOn": "string"
    },
    "lastUpdateTime": "2026-01-31T12:00:00Z",
    "name": "Acme Corp",
    "organizationId": "01H0000000000000000000",
    "status": "ACTIVE"
  }
]

Error — 400

"string"

View as Markdown · Interactive API reference

Spotted something wrong or out of date on this page? Tell us and we'll correct it.