---
title: "Changes to Submit a selection Vwala will switch on the customer's behalf"
method: POST
path: "/v1/checkout"
---

# Changes to Submit a selection Vwala will switch on the customer's behalf

`POST /v1/checkout`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 11 revisions.

- **2026-10-03** `69118612e1fe`: 3 info
- **2026-09-23** `d5942334de4e`: 11 warning
- **2026-09-22** `1673faf11a0f`: 10 breaking, 1 warning, 16 info
- **2026-09-03** `b2511b6c1cfa`: 2 info
- **2026-08-20** `86688c4fea92`: 22 breaking, 10 warning, 4 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`: 10 breaking, 1 warning, 16 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 `eans/electricity` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `eans/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 `consentGivenAt` request property type changed from `string` to no type, and format from `date-time` to no format
  - the `contractStartDate` request property type changed from `string` to no type, and format from `date-time` to no format
  - changed the pattern of the request property `customer/email` from `^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$` to `^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$`
  - added `subschema #1, subschema #2` to the `consentGivenAt` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `contractStartDate` request property `anyOf` list
  - the request property `context/currentMerchants/electricity` became nullable
  - the request property `context/currentMerchants/gas` became nullable
  - the request property `eans/electricity` became nullable
  - the request property `eans/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
  - removed the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` from the request property `consentGivenAt`
  - removed the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` from the request property `contractStartDate`
  - the `anyOf[subschema #1]/meta/issues/items/anyOf[subschema #4]/maximum` response's property pattern was changed from `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$` for the status `400`
  - the `anyOf[subschema #1]/meta/issues/items/anyOf[subschema #4]/maximum` response's property pattern was changed from `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$` for the status `422`
  - the `anyOf[subschema #1]/meta/issues/items/anyOf[subschema #4]/minimum` response's property pattern was changed from `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$` for the status `400`
  - the `anyOf[subschema #1]/meta/issues/items/anyOf[subschema #4]/minimum` response's property pattern was changed from `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$` for the status `422`
- **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-20** `86688c4fea92`: 22 breaking, 10 warning, 4 info
  - request property `billingPreference` was restricted to a list of enum values
  - the request property `billingPreference` became required
  - the request property `contractStartDate` became required
  - the request property `customer/address` became required
  - the request property `customer/iban` became required
  - the request property `customer/mobilePhone` became required
  - request property `billingPreference` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `contractStartDate` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `customer/address` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `customer/iban` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `customer/mobilePhone` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `customer/address` request property's minLength was increased from `0` to `1`
  - the `customer/mobilePhone` request property's minLength was increased from `0` to `1`
  - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` to the request property `contractStartDate`
  - the response's body type changed from `object` to no type for status `400`
  - the response's body type changed from `object` to no type for status `422`
  - removed the required property `status` from the response with the `400` status
  - removed the required property `status` from the response with the `422` status
  - removed the required property `title` from the response with the `400` status
  - removed the required property `title` from the response with the `422` status
  - removed the required property `type` from the response with the `400` status
  - removed the required property `type` from the response with the `422` status
  - removed the optional property `detail` from the response with the `400` status
  - removed the optional property `detail` from the response with the `422` status
  - removed the optional property `errors` from the response with the `400` status
  - removed the optional property `errors` from the response with the `422` status
  - removed the optional property `instance` from the response with the `400` status
  - removed the optional property `instance` from the response with the `422` status
  - removed the optional property `meta` from the response with the `400` status
  - removed the optional property `meta` from the response with the `422` status
  - removed the optional property `traceId` from the response with the `400` status
  - removed the optional property `traceId` from the response with the `422` status
  - added the new `ADVANCE_INVOICE` enum value to the request property `billingPreference`
  - added the new `MONTHLY_SETTLEMENT` enum value to the request property `billingPreference`
  - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `400`
  - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `422`
- **2026-08-18** `0faefa545909`: 1 info
  - endpoint added

---

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