---
title: "Changes to Record a selection the customer completes at the merchant"
method: POST
path: "/v1/handoff"
---

# Changes to Record a selection the customer completes at the merchant

`POST /v1/handoff`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 11 revisions.

- **2026-10-03** `69118612e1fe`: 3 info
- **2026-09-23** `d5942334de4e`: 11 warning
- **2026-09-22** `1673faf11a0f`: 6 breaking, 6 info
- **2026-09-03** `b2511b6c1cfa`: 2 info
- **2026-08-18** `0faefa545909`: 1 info

## Changes

- **2026-10-03** `69118612e1fe`: 3 info
  - added the new optional request property `locale`
  - added the required property `boltHandoffAuthorized` to the response with the `201` status
  - added the required property `submissionMethods` to the response with the `201` status
- **2026-09-23** `d5942334de4e`: 11 warning
  - the `intake/consumption/electricity/anyOf[subschema #1]/consumptionDayKwh/anyOf[subschema #1]/` request property's max was set to `1000000.00`
  - the `intake/consumption/electricity/anyOf[subschema #1]/consumptionExclusiveNightKwh/anyOf[subschema #1]/` request property's max was set to `1000000.00`
  - the `intake/consumption/electricity/anyOf[subschema #1]/consumptionNightKwh/anyOf[subschema #1]/` request property's max was set to `1000000.00`
  - the `intake/consumption/electricity/anyOf[subschema #1]/consumptionTotalKwh` request property's max was set to `1000000.00`
  - the `intake/consumption/electricity/anyOf[subschema #1]/injectionDayKwh/anyOf[subschema #1]/` request property's max was set to `1000000.00`
  - the `intake/consumption/electricity/anyOf[subschema #1]/injectionNightKwh/anyOf[subschema #1]/` request property's max was set to `1000000.00`
  - the `intake/consumption/electricity/anyOf[subschema #1]/injectionTotalKwh/anyOf[subschema #1]/` request property's max was set to `1000000.00`
  - the `intake/consumption/electricity/anyOf[subschema #1]/peakConsumptionKw/anyOf[subschema #1]/` request property's max was set to `10000.00`
  - the `intake/consumption/gas/anyOf[subschema #1]/consumptionTotalKwh` request property's max was set to `1000000.00`
  - the `intake/referenceCost/electricity/anyOf[subschema #1]/yearlyInclVat/anyOf[subschema #1]/` request property's max was set to `1000000.00`
  - the `intake/referenceCost/gas/anyOf[subschema #1]/yearlyInclVat/anyOf[subschema #1]/` request property's max was set to `1000000.00`
- **2026-09-22** `1673faf11a0f`: 6 breaking, 6 info
  - request property `context/currentMerchants/electricity` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `context/currentMerchants/gas` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `intake/referenceCost/electricity/anyOf[subschema #1]/currentMerchant` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `intake/referenceCost/electricity/anyOf[subschema #1]/currentProduct` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `intake/referenceCost/gas/anyOf[subschema #1]/currentMerchant` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `intake/referenceCost/gas/anyOf[subschema #1]/currentProduct` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the request property `context/currentMerchants/electricity` became nullable
  - the request property `context/currentMerchants/gas` became nullable
  - the request property `intake/referenceCost/electricity/anyOf[subschema #1]/currentMerchant` became nullable
  - the request property `intake/referenceCost/electricity/anyOf[subschema #1]/currentProduct` became nullable
  - the request property `intake/referenceCost/gas/anyOf[subschema #1]/currentMerchant` became nullable
  - the request property `intake/referenceCost/gas/anyOf[subschema #1]/currentProduct` became nullable
- **2026-09-03** `b2511b6c1cfa`: 2 info
  - added the new optional request property `intake/consumption/electricity/anyOf[subschema #1]/consumptionExclusiveNightKwh`
  - added the new optional request property `intake/supplyPoint/hasExclusiveNightRegister`
- **2026-08-18** `0faefa545909`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/vwala/apis/energy-platform-api/docs/v1/handoff/post.md) - [API](https://skmtc.dev/vwala/apis/energy-platform-api.md) - [Page](https://skmtc.dev/vwala/apis/energy-platform-api/changes/v1/handoff/post)