List Billable Metrics

API Reference

Customers

Get billable metrics for a customer

client.V1.Customers.ListBillableMetrics(ctx, params) (*CursorPage[], error)

get/v1/customers/{customer_id}/billable-metrics

Get all billable metrics for a given customer.

Parameters

params

Hide ParametersShow Parameters

CustomerIDfield

param.Field[string]

Path param:

formatuuid

IncludeArchivedfield

optional

param.Field[bool]

Query param: If true, the list of returned metrics will include archived metrics

Limitfield

optional

param.Field[int64]

Query param: Max number of results that should be returned

minimum1

maximum100

NextPagefield

optional

param.Field[string]

Query param: Cursor that indicates where the next page of results should start.

OnCurrentPlanfield

optional

param.Field[bool]

Query param: If true, the list of metrics will be filtered to just ones that are on the customer's current plan

Returns

V1CustomerListBillableMetricsResponsestruct

Hide ParametersShow Parameters

IDstring

formatuuid

Namestring

Aggregatestring

optional

(DEPRECATED) use aggregation_type instead

AggregateKeysarray

optional

[]string

(DEPRECATED) use aggregation_key instead

AggregationKeystring

optional

A key that specifies which property of the event is used to aggregate data. This key must be one of the property filter names and is not applicable when the aggregation type is 'count'.

AggregationType

optional

Specifies the type of aggregation performed on matching events.

Hide ParametersShow Parameters

V1CustomerListBillableMetricsResponseAggregationTypeCountconst

"COUNT"

V1CustomerListBillableMetricsResponseAggregationTypeLatestconst

"LATEST"

V1CustomerListBillableMetricsResponseAggregationTypeMaxconst

"MAX"

V1CustomerListBillableMetricsResponseAggregationTypeSumconst

"SUM"

V1CustomerListBillableMetricsResponseAggregationTypeUniqueconst

"UNIQUE"

ArchivedAtTime

optional

RFC 3339 timestamp indicating when the billable metric was archived. If not provided, the billable metric is not archived.

formatdate-time

CustomFieldsmap

optional

map[string, string]

EventTypeFilter

optional

An optional filtering rule to match the 'event_type' property of an event.

Filtermap

optional

map[string, unknown]

(DEPRECATED) use property_filters & event_type_filter instead

GroupByarray

optional

[]string

(DEPRECATED) use group_keys instead

GroupKeysarray

optional

[][]string

Property names that are used to group usage costs on an invoice. Each entry represents a set of properties used to slice events into distinct buckets.

PropertyFiltersarray

optional

[]

A list of filters to match events to this billable metric. Each filter defines a rule on an event property. All rules must pass for the event to match the billable metric.

Hide ParametersShow Parameters

Namestring

The name of the event property.

Existsbool

optional

Determines whether the property must exist in the event. If true, only events with this property will pass the filter. If false, only events without this property will pass the filter. If null or omitted, the existence of the property is optional.

InValuesarray

optional

[]string

Specifies the allowed values for the property to match an event. An event will pass the filter only if its property value is included in this list. If undefined, all property values will pass the filter. Must be non-empty if present.

NotInValuesarray

optional

[]string

Specifies the values that prevent an event from matching the filter. An event will not pass the filter if its property value is included in this list. If null or empty, all property values will pass the filter. Must be non-empty if present.

Sqlstring

optional

The SQL query associated with the billable metric

package main

import (
  "context"
  "fmt"

  "github.com/Metronome-Industries/metronome-go"
  "github.com/Metronome-Industries/metronome-go/option"
)

func main() {
  client := metronome.NewClient(
    option.WithBearerToken("My Bearer Token"),
  )
  page, err := client.V1.Customers.ListBillableMetrics(context.TODO(), metronome.V1CustomerListBillableMetricsParams{
    CustomerID: metronome.F("d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}

200 Example

{
  "data": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "name": "name",
      "aggregate": "aggregate",
      "aggregate_keys": [
        "string"
      ],
      "aggregation_key": "aggregation_key",
      "aggregation_type": "COUNT",
      "archived_at": "2019-12-27T18:11:19.117Z",
      "custom_fields": {
        "foo": "string"
      },
      "event_type_filter": {
        "in_values": [
          "string"
        ],
        "not_in_values": [
          "string"
        ]
      },
      "filter": {
        "foo": "bar"
      },
      "group_by": [
        "string"
      ],
      "group_keys": [
        [
          "string"
        ]
      ],
      "property_filters": [
        {
          "name": "name",
          "exists": true,
          "in_values": [
            "string"
          ],
          "not_in_values": [
            "string"
          ]
        }
      ],
      "sql": "sql"
    }
  ],
  "next_page": "next_page"
}