---
title: "Set a SoC-based charging plan"
method: POST
path: "/vehicles/{name}/plan/soc/{soc}/{timestamp}"
tags: ["vehicles"]
---

# Set a SoC-based charging plan

`POST /vehicles/{name}/plan/soc/{soc}/{timestamp}`

Create charging plan with fixed time and SoC target.

## Path parameters

- `name` string, required
- `soc` number, required — SOC in %
- `timestamp` string, date-time, required — Timestamp in RFC3339 format

## Response `200`

Success

- object
  - `soc` number — SOC in %
  - `time` string, date-time — Timestamp in RFC3339 format

## Changes

- **2026-07-20** `32e824ccacfe` — 1 warning, 2 info
  - removed the optional property `result` from the response with the `200` status
  - added the optional property `soc` to the response with the `200` status
  - added the optional property `time` to the response with the `200` status
- **2025-12-31** `522c8a4fb8e9` — 2 warning
  - deleted the `query` request parameter `precondition`
  - removed the optional property `result/precondition` from the response with the `200` status
- **2025-12-31** `9542b598863d` — 2 info
  - added the new optional `query` request parameter `precondition`
  - added the optional property `result/precondition` to the response with the `200` status
- **2025-12-30** `522c8a4fb8e9` — 2 warning
  - deleted the `query` request parameter `precondition`
  - removed the optional property `result/precondition` from the response with the `200` status
- **2025-08-10** `c4027a2cb484` — 1 info
  - api operation id `setVehicleSocPlan` was added

[Full history](https://skmtc.dev/evcc-io/apis/evcc/changes/vehicles/:name/plan/soc/:soc/:timestamp/post.md)

---

[API](https://skmtc.dev/evcc-io/apis/evcc.md) · [All operations](https://skmtc.dev/evcc-io/apis/evcc/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evcc-io/evcc/revisions/5152af83a070/schema)