---
title: "Add or update a price formula for a meter by meter external reference."
method: POST
path: "/meters/{meterId}/priceformulas"
tags: ["Meter Price Formulas"]
---

# Add or update a price formula for a meter by meter external reference.

`POST /meters/{meterId}/priceformulas`

## Request

- Base URL: `https://eliq.data-management-api.eliq.com` (the document declares no server; this is the origin it was published from)
- URL: `https://eliq.data-management-api.eliq.com/meters/{meterId}/priceformulas`
- Auth: none declared
- TypeScript: <https://skmtc.dev/eliq/apis/eliq-data-management-api/docs/meters/:meterId/priceformulas/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `meterId` string, required

## Request body

- PriceFormula
  - `name` string, nullable
  - `from` string, nullable
  - `to` string, nullable
  - `currency_code` string, nullable
  - `elements` Element[], nullable
    - `name` string, nullable
    - `type` string, nullable
    - `charge` Charge
      - `resolution` string, nullable
      - `charge` number, double, nullable
      - `type` string, nullable
      - `capacity_tariff` CapacityTariff
        - `charge_tariff` number, double
        - `minimum_contribution` number, double
        - `calculation_type` string, nullable
    - `unit_rate` UnitRate
      - `type` string, nullable
      - `fixed` Fixed
        - `unit_rate` number, double, nullable
      - `tou` Tou
        - `register_id` string, nullable
        - `unit_rate` number, double, nullable
        - `intervals` Interval[], nullable
          - `from_minute` integer, nullable
          - `to_minute` integer, nullable
        - `skip_intervals` boolean, nullable
      - `block` Block
        - `resolution` string, nullable
        - `register_id` string, nullable
        - `unit_rate` number, double
        - `from_kwh` integer, nullable
        - `to_kwh` integer, nullable
        - `from_m3` integer, nullable
        - `to_m3` integer, nullable
      - `spot_price` SpotPrice
        - `provider` string, nullable
        - `region` string, nullable
        - `resolution` string, nullable
        - `multiplier` number, double, nullable
      - `weekdays` string[], nullable
  - `price_multiplier` number, double, nullable
  - `energy_unit` string, nullable

## Response `200`

OK

- PriceFormula
  - `name` string, nullable
  - `from` string, nullable
  - `to` string, nullable
  - `currency_code` string, nullable
  - `elements` Element[], nullable
    - `name` string, nullable
    - `type` string, nullable
    - `charge` Charge
      - `resolution` string, nullable
      - `charge` number, double, nullable
      - `type` string, nullable
      - `capacity_tariff` CapacityTariff
        - `charge_tariff` number, double
        - `minimum_contribution` number, double
        - `calculation_type` string, nullable
    - `unit_rate` UnitRate
      - `type` string, nullable
      - `fixed` Fixed
        - `unit_rate` number, double, nullable
      - `tou` Tou
        - `register_id` string, nullable
        - `unit_rate` number, double, nullable
        - `intervals` Interval[], nullable
          - `from_minute` integer, nullable
          - `to_minute` integer, nullable
        - `skip_intervals` boolean, nullable
      - `block` Block
        - `resolution` string, nullable
        - `register_id` string, nullable
        - `unit_rate` number, double
        - `from_kwh` integer, nullable
        - `to_kwh` integer, nullable
        - `from_m3` integer, nullable
        - `to_m3` integer, nullable
      - `spot_price` SpotPrice
        - `provider` string, nullable
        - `region` string, nullable
        - `resolution` string, nullable
        - `multiplier` number, double, nullable
      - `weekdays` string[], nullable
  - `price_multiplier` number, double, nullable
  - `energy_unit` string, nullable

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/eliq/apis/eliq-data-management-api.md) - [All operations](https://skmtc.dev/eliq/apis/eliq-data-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eliq/apis/eliq-data-management-api/revisions/022af911e0d0?raw)