---
title: "Household cost-optimal charge schedule (Home+)"
method: POST
path: "/v1/optimize/schedule"
---

# Household cost-optimal charge schedule (Home+)

`POST /v1/optimize/schedule`

## Request

- Base URL: `https://voltcast.com/api`
- URL: `https://voltcast.com/api/v1/optimize/schedule`
- Auth: HTTP bearer

## Request body

- object
  - `zone` string, required
  - `energy_kwh` number, required
  - `max_power_kw` number, required
  - `deadline` string, date-time, required
  - `start` string, date-time
  - `tariff` object: Optional user-supplied variable household charges.
    - `grid_fee_eur_kwh` number
    - `supplier_markup_eur_kwh` number
    - `vat_percent` number

## Response `200`

Device-ready charging slots plus tariff-adjusted and wholesale-only expected/baseline costs. Coarser source prices are explicitly labeled when subdivided.

---

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