---
title: "Appliance Energy Cost Calculator"
method: POST
path: "/api/v1/tools/appliance-energy-cost-calculator"
tags: ["tools"]
---

# Appliance Energy Cost Calculator

`POST /api/v1/tools/appliance-energy-cost-calculator`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/tools/appliance-energy-cost-calculator`
- Auth: HTTP bearer

Price what an appliance costs to run, from its wattage, how it is used and the price of a kilowatt hour. Takes either a daily pattern (hours a day) or a weekly one (runs per week times minutes a run), and returns kilowatt hours and money per day, per month and per year.

## Request body

- object
  - `watts` integer
  - `pricePerKwh` number
  - `mode` string
  - `hoursPerDay` integer
  - `usesPerWeek` integer
  - `minutesPerUse` integer

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `watts` integer
    - `mode` string
    - `pricePerKwh` number
    - `kwhDay` number
    - `kwhMonth` number
    - `kwhYear` number
    - `costDay` number
    - `costMonth` number
    - `costYear` number
    - `hoursPerDay` integer

## Other responses

- `400`: Missing or invalid request fields
- `401`: Invalid or missing API key
- `429`: Monthly plan limit reached

---

[API](https://skmtc.dev/toolforte/apis/toolforte-api.md) · [All operations](https://skmtc.dev/toolforte/apis/toolforte-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolforte/apis/toolforte-api/revisions/4d814d484dfc?raw)