---
title: "Delete a billable metric"
method: DELETE
path: "/billable_metrics/{code}"
tags: ["billable_metrics"]
---

# Delete a billable metric

`DELETE /billable_metrics/{code}`

This endpoint deletes an existing billable metric representing a pricing component of your application.

## Response `200`

Billable metric deleted

- BillableMetric
  - `billable_metric` BillableMetricObject, required
    - `lago_id` string, uuid, required — Unique identifier of the billable metric created by Lago.
    - `name` string, required — Name of the billable metric.
    - `code` string, required — Unique code used to identify the billable metric associated with the API request. This code associates each event with the correct metric.
    - `description` string, nullable — Internal description of the billable metric.
    - `recurring` boolean, required — Defines if the billable metric is persisted billing period over billing period. - If set to `true`: the accumulated number of units calculated from the previous billing period is persisted to the next billing period. - If set to `false`: the accumulated number of units is reset to 0 at the end of the billing period. - If not defined in the request, default value is `false`.
    - `rounding_function` 'ceil' | 'floor' | 'round' | 'null', nullable — Refers to the numeric value or mathematical expression that will be rounded based on the calculated number of billing units. Possible values are `round`, `ceil` and `floor`.
    - `rounding_precision` integer, nullable — Specifies the number of decimal places to which the `rounding_function` will be rounded. It can be a positive or negative value.
    - `created_at` string, date-time, required — Creation date of the billable metric.
    - `expression` string — Expression used to calculate the event units. The expression is evalutated for each event and the result is then used to calculate the total aggregated units.
    - `field_name` string, nullable — Property of the billable metric used for aggregating usage data. This field is not required for `count_agg`.
    - `aggregation_type` 'count_agg' | 'sum_agg' | 'max_agg' | 'unique_count_agg' | 'weighted_sum_agg' | 'latest_agg', required — Aggregation method used to compute usage for this billable metric.
    - `weighted_interval` 'seconds' | 'null', nullable — Parameter exclusively utilized in conjunction with the `weighted_sum` aggregation type. It serves to adjust the aggregation result by assigning weights and proration to the result based on time intervals. When this field is not provided, the default time interval is assumed to be in `seconds`.
    - `filters` BillableMetricFilterObject[]
      - `key` string, required — Filter key to add to the event properties payload
      - `values` string[], required — List of possible filter values

## Other responses

- `401` — Unauthorized error
- `404` — Not Found error

---

[API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) · [All operations](https://skmtc.dev/getlago/apis/lago-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getlago/lago-api-documentation/revisions/6e969ef3bb45/schema)