POST
/
metrics
{
  "name": "Amex Consumer",
  "description": "No. of Amex Consumer Cards",
  "eventName": "transactions",
  "filterGroups": [
    {
      "operator": "and",
      "filters": [
        {
          "field": "card_scheme",
          "operator": "equal",
          "value": "amex"
        },
        {
          "field": "card_offering",
          "operator": "equal",
          "value": "consumer"
        }
      ]
    }
  ],
  "aggregation": {
    "method": "sum",
    "field": "txn_value"
  }
}


{
  "id": "mtr_02zBU3PJ3hJurtFSxDD3Ol",
  "description": "No. of Amex Consumer Cards",
  "name": "Amex Consumer",
  "eventName": "transactions",
  "filters": [
    {
      "operator": "and",
      "filters": [
        {
          "field": "card_scheme",
          "operator": "equal",
          "value": "amex"
        },
        {
          "field": "card_offering",
          "operator": "equal",
          "value": "consumer"
        }
      ]
    }
  ],
  "aggregation": {
    "method": "sum",
    "field": "txn_value"
  },
  "createdAt": "2025-02-24T12:09:05.350876Z",
  "updatedAt": "2025-02-24T12:09:05.350877Z",
  "organizationID": "8641473c-2d34-46c6-b712-c893934fc8fb"
}

Allows you to create a billable metric out of the raw ingested events.

​
Request

{
  "name": "Amex Consumer",
  "description": "No. of Amex Consumer Cards",
  "eventName": "transactions",
  "filterGroups": [
    {
      "operator": "and",
      "filters": [
        {
          "field": "card_scheme",
          "operator": "equal",
          "value": "amex"
        },
        {
          "field": "card_offering",
          "operator": "equal",
          "value": "consumer"
        }
      ]
    }
  ],
  "aggregation": {
    "method": "sum",
    "field": "txn_value"
  }
}
​
name
string
required

The name of the billable metric. This should be clear and concise to represent the usage you are tracking.

​
description
string
required

A detailed explanation of what the metric measures, such as the number of specific customer transactions.

​
eventName
string
required

The name of the event that triggers the metric. This event represents a customer action or transaction.

​
filterGroups
[]object

An array of filter groups used to refine which events contribute to the metric. Filters allow you to narrow down events based on specific properties.

​
aggregation
object
required

The aggregation settings for the metric. This defines how event data is calculated to produce the final metric value.

​
Response

​
id
string

The unique identifier for the metric.

​
description
string

A brief description of what the metric measures.

​
name
string

The name of the metric.

​
eventName
string

The event that triggers the metric.

​
filters
[]object

An array of filter groups applied to the metric to narrow down the events counted.

​
aggregation
object

The aggregation settings that define how the events are calculated to produce the metric value.

​
createdAt
datetime

The timestamp when the metric was created.

​
updatedAt
datetime

The timestamp when the metric was last updated.

​
organizationID
string

The unique identifier for the organization associated with the metric.

{
  "id": "mtr_02zBU3PJ3hJurtFSxDD3Ol",
  "description": "No. of Amex Consumer Cards",
  "name": "Amex Consumer",
  "eventName": "transactions",
  "filters": [
    {
      "operator": "and",
      "filters": [
        {
          "field": "card_scheme",
          "operator": "equal",
          "value": "amex"
        },
        {
          "field": "card_offering",
          "operator": "equal",
          "value": "consumer"
        }
      ]
    }
  ],
  "aggregation": {
    "method": "sum",
    "field": "txn_value"
  },
  "createdAt": "2025-02-24T12:09:05.350876Z",
  "updatedAt": "2025-02-24T12:09:05.350877Z",
  "organizationID": "8641473c-2d34-46c6-b712-c893934fc8fb"
}
Ingest Billable EventsGet Billable Metric