POST request/Switch/Pro/Update/Terms-And-Conditions

Adds/Updates terms and conditions for a customer's switch. Default values for AllUpdatesRemindersAndThirdPartyOverride and AllUpdatesRemindersOverride is null. Note that the information obtained at "POST request/Switch/Pro/Detail/Terms-And-Conditions" overrides the Additional Information in the Body Parameters that are stated here.

Request Information

URI Parameters

None.

Body Parameters

The details terms and conditions binding model.

DetailsTermsAndConditionsBindingModel

Name	Type	Additional information
AllUpdatesRemindersAndThirdPartyOverride	boolean	None.
AllUpdatesRemindersOverride	boolean	None.
BillingPreference	BillingPreference	Required
CampaignCode	string	None.
CommunicationPreferrenceOverride	CommunicationPreferrenceOverride	Required
CommunityProgrammeReference	string	String length: inclusive between 0 and 50
consent1	boolean	None.
consent2	boolean	None.
consent3	boolean	None.
CoOperativeMembershipNumber	string	None.
Cot	boolean	None.
ElectricitySmartMeterInstalled	boolean	None.
EmailUpdatesByMyUtilitygenius	boolean	Required
EnsureAllAutoSwitchOptions	boolean	None.
EonPaperlessBillingWanted	boolean	None.
EonPriceAlertsWanted	boolean	None.
EonRewardsWanted	boolean	None.
GasMainsConnectionToo	boolean	None.
GasSmartMeterInstalled	boolean	None.
HappyToHaveDebtInformationAccessed	boolean	Required
HappyToReceiveCreditCheck	boolean	Required
HappyWithNpowerTerms	boolean	Required
HasElectricityDebt	boolean	None.
HasGasDebt	boolean	None.
HasMedicalConditionOrIndividualRequirement	boolean	None.
InterestedInJoiningTheCoOperative	boolean	None.
IsHappyToBeAutoSwitched	boolean	None.
IsPaper	boolean	None.
IsSharedInfo	boolean	None.
IsTou	boolean	None.
Language	string	None.
MpanNumber	string	Required Max length: 21
MprnNumber	string	Required Max length: 10 Min length: 6
OnlinePassword	string	Required Data type: Password
OnlinePasswordConfirmation	string	Data type: Password
OvoFoundationOption	OvoFoundationOption	Required
OvoSecurityAnswer	string	Required
OvoSecurityQuestion	OvoSecurityQuestion	Required
PreferredCommunicationFormat	string	None.
PreferredCommunicationMethod	string	None.
PreferredSwitchDate	date	Data type: Date
PrePaymentMeterId	integer	Required Range: inclusive between 1 and 256
ReferralId	integer	Required Range: inclusive between 1 and 256
ReferralOption	string	None.
SpecialNeedsId	integer	None.
SpecialNeedsList	Collection of byte	None.
SupplierMaySendImportantAccountChangesViaEmail	boolean	None.
SupplierMaySendRemindersAndUpdatesViaEmailAboutAccount	boolean	None.
SupplierMaySendRemindersAndUpdatesViaTelephoneAboutAccount	boolean	None.
SupplierMaySendUpdatesThatMayBeOfInterestViaDayPhone	boolean	None.
SupplierMaySendUpdatesThatMayBeOfInterestViaEmail	boolean	None.
SupplierMaySendUpdatesThatMayBeOfInterestViaEveningPhone	boolean	None.
SupplierMaySendUpdatesThatMayBeOfInterestViaFaceToFace	boolean	None.
SupplierMaySendUpdatesThatMayBeOfInterestViaIVM	boolean	None.
SupplierMaySendUpdatesThatMayBeOfInterestViaMobilePhone	boolean	None.
SupplierMaySendUpdatesThatMayBeOfInterestViaPost	boolean	None.
SupplierMaySendUpdatesThatMayBeOfInterestViaSms	boolean	None.
SuppliersTermsAndConditionsAreAccepted	boolean	Required
SwitchAfterCoolingOfPeriod	boolean	None.
SwitchKey	string	Required Max length: 50 Min length: 1
TescoClubCardNumber	string	None.
ThreeMonthsOrLess	boolean	None.
YesIamOnAGreenDeal	boolean	None.

Request Formats

application/json, text/json

Sample:

{
  "mprnNumber": "sample string 1",
  "gasSmartMeterInstalled": true,
  "mpanNumber": "sample string 3",
  "electricitySmartMeterInstalled": true,
  "gasMainsConnectionToo": true,
  "suppliersTermsAndConditionsAreAccepted": true,
  "hasMedicalConditionOrIndividualRequirement": true,
  "specialNeedsId": 1,
  "specialNeedsList": [
    64,
    64
  ],
  "language": "sample string 8",
  "happyToReceiveCreditCheck": true,
  "happyWithNpowerTerms": true,
  "happyToHaveDebtInformationAccessed": true,
  "hasElectricityDebt": true,
  "hasGasDebt": true,
  "supplierMaySendImportantAccountChangesViaEmail": true,
  "emailUpdatesByMyUtilitygenius": true,
  "preferredSwitchDate": "2025-10-27T20:11:44.5826628+00:00",
  "onlinePassword": "sample string 16",
  "onlinePasswordConfirmation": "sample string 17",
  "eonRewardsWanted": true,
  "eonPriceAlertsWanted": true,
  "eonPaperlessBillingWanted": true,
  "isSharedInfo": true,
  "billingPreference": "Paper",
  "prePaymentMeterId": 22,
  "tescoClubCardNumber": "sample string 23",
  "coOperativeMembershipNumber": "sample string 24",
  "interestedInJoiningTheCoOperative": true,
  "referralId": 26,
  "referralOption": "sample string 27",
  "supplierMaySendRemindersAndUpdatesViaTelephoneAboutAccount": true,
  "supplierMaySendRemindersAndUpdatesViaEmailAboutAccount": true,
  "supplierMaySendUpdatesThatMayBeOfInterestViaDayPhone": true,
  "supplierMaySendUpdatesThatMayBeOfInterestViaEveningPhone": true,
  "supplierMaySendUpdatesThatMayBeOfInterestViaMobilePhone": true,
  "supplierMaySendUpdatesThatMayBeOfInterestViaSms": true,
  "supplierMaySendUpdatesThatMayBeOfInterestViaEmail": true,
  "supplierMaySendUpdatesThatMayBeOfInterestViaPost": true,
  "supplierMaySendUpdatesThatMayBeOfInterestViaFaceToFace": true,
  "supplierMaySendUpdatesThatMayBeOfInterestViaIVM": true,
  "campaignCode": "sample string 38",
  "yesIamOnAGreenDeal": true,
  "ovoFoundationOption": "NoDonation",
  "ovoSecurityQuestion": "WhatWouldBeYourSuperpowerIfYouHadOne",
  "ovoSecurityAnswer": "sample string 40",
  "communicationPreferrenceOverride": "None",
  "allUpdatesRemindersAndThirdPartyOverride": true,
  "allUpdatesRemindersOverride": true,
  "isHappyToBeAutoSwitched": true,
  "ensureAllAutoSwitchOptions": true,
  "communityProgrammeReference": "sample string 43",
  "isPaper": true,
  "consent1": true,
  "consent2": true,
  "consent3": true,
  "switchAfterCoolingOfPeriod": true,
  "preferredCommunicationMethod": "sample string 45",
  "preferredCommunicationFormat": "sample string 46",
  "threeMonthsOrLess": true,
  "cot": true,
  "switchKey": "sample string 49",
  "isTou": true
}

application/xml, text/xml

Sample:

<DetailsTermsAndConditionsBindingModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/MyUtilityGenius.Api.Domain.Default.BindingModel">
  <IsTou>true</IsTou>
  <SwitchKey>sample string 49</SwitchKey>
  <AllUpdatesRemindersAndThirdPartyOverride>true</AllUpdatesRemindersAndThirdPartyOverride>
  <AllUpdatesRemindersOverride>true</AllUpdatesRemindersOverride>
  <BillingPreference>Paper</BillingPreference>
  <CampaignCode>sample string 38</CampaignCode>
  <CoOperativeMembershipNumber>sample string 24</CoOperativeMembershipNumber>
  <CommunicationPreferrenceOverride>None</CommunicationPreferrenceOverride>
  <CommunityProgrammeReference>sample string 43</CommunityProgrammeReference>
  <Cot>true</Cot>
  <ElectricitySmartMeterInstalled>true</ElectricitySmartMeterInstalled>
  <EmailUpdatesByMyUtilitygenius>true</EmailUpdatesByMyUtilitygenius>
  <EnsureAllAutoSwitchOptions>true</EnsureAllAutoSwitchOptions>
  <EonPaperlessBillingWanted>true</EonPaperlessBillingWanted>
  <EonPriceAlertsWanted>true</EonPriceAlertsWanted>
  <EonRewardsWanted>true</EonRewardsWanted>
  <GasMainsConnectionToo>true</GasMainsConnectionToo>
  <GasSmartMeterInstalled>true</GasSmartMeterInstalled>
  <HappyToHaveDebtInformationAccessed>true</HappyToHaveDebtInformationAccessed>
  <HappyToReceiveCreditCheck>true</HappyToReceiveCreditCheck>
  <HappyWithNpowerTerms>true</HappyWithNpowerTerms>
  <HasElectricityDebt>true</HasElectricityDebt>
  <HasGasDebt>true</HasGasDebt>
  <HasMedicalConditionOrIndividualRequirement>true</HasMedicalConditionOrIndividualRequirement>
  <InterestedInJoiningTheCoOperative>true</InterestedInJoiningTheCoOperative>
  <IsHappyToBeAutoSwitched>true</IsHappyToBeAutoSwitched>
  <IsPaper>true</IsPaper>
  <IsSharedInfo>true</IsSharedInfo>
  <Language>sample string 8</Language>
  <MpanNumber>sample string 3</MpanNumber>
  <MprnNumber>sample string 1</MprnNumber>
  <OnlinePassword>sample string 16</OnlinePassword>
  <OnlinePasswordConfirmation>sample string 17</OnlinePasswordConfirmation>
  <OvoFoundationOption>NoDonation</OvoFoundationOption>
  <OvoSecurityAnswer>sample string 40</OvoSecurityAnswer>
  <OvoSecurityQuestion>WhatWouldBeYourSuperpowerIfYouHadOne</OvoSecurityQuestion>
  <PrePaymentMeterId>22</PrePaymentMeterId>
  <PreferredCommunicationFormat>sample string 46</PreferredCommunicationFormat>
  <PreferredCommunicationMethod>sample string 45</PreferredCommunicationMethod>
  <PreferredSwitchDate>2025-10-27T20:11:44.5826628+00:00</PreferredSwitchDate>
  <ReferralId>26</ReferralId>
  <ReferralOption>sample string 27</ReferralOption>
  <SpecialNeedsId>1</SpecialNeedsId>
  <SpecialNeedsList xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:unsignedByte>64</d2p1:unsignedByte>
    <d2p1:unsignedByte>64</d2p1:unsignedByte>
  </SpecialNeedsList>
  <SupplierMaySendImportantAccountChangesViaEmail>true</SupplierMaySendImportantAccountChangesViaEmail>
  <SupplierMaySendRemindersAndUpdatesViaEmailAboutAccount>true</SupplierMaySendRemindersAndUpdatesViaEmailAboutAccount>
  <SupplierMaySendRemindersAndUpdatesViaTelephoneAboutAccount>true</SupplierMaySendRemindersAndUpdatesViaTelephoneAboutAccount>
  <SupplierMaySendUpdatesThatMayBeOfInterestViaDayPhone>true</SupplierMaySendUpdatesThatMayBeOfInterestViaDayPhone>
  <SupplierMaySendUpdatesThatMayBeOfInterestViaEmail>true</SupplierMaySendUpdatesThatMayBeOfInterestViaEmail>
  <SupplierMaySendUpdatesThatMayBeOfInterestViaEveningPhone>true</SupplierMaySendUpdatesThatMayBeOfInterestViaEveningPhone>
  <SupplierMaySendUpdatesThatMayBeOfInterestViaFaceToFace>true</SupplierMaySendUpdatesThatMayBeOfInterestViaFaceToFace>
  <SupplierMaySendUpdatesThatMayBeOfInterestViaIVM>true</SupplierMaySendUpdatesThatMayBeOfInterestViaIVM>
  <SupplierMaySendUpdatesThatMayBeOfInterestViaMobilePhone>true</SupplierMaySendUpdatesThatMayBeOfInterestViaMobilePhone>
  <SupplierMaySendUpdatesThatMayBeOfInterestViaPost>true</SupplierMaySendUpdatesThatMayBeOfInterestViaPost>
  <SupplierMaySendUpdatesThatMayBeOfInterestViaSms>true</SupplierMaySendUpdatesThatMayBeOfInterestViaSms>
  <SuppliersTermsAndConditionsAreAccepted>true</SuppliersTermsAndConditionsAreAccepted>
  <SwitchAfterCoolingOfPeriod>true</SwitchAfterCoolingOfPeriod>
  <TescoClubCardNumber>sample string 23</TescoClubCardNumber>
  <ThreeMonthsOrLess>true</ThreeMonthsOrLess>
  <YesIamOnAGreenDeal>true</YesIamOnAGreenDeal>
  <consent1>true</consent1>
  <consent2>true</consent2>
  <consent3>true</consent3>
</DetailsTermsAndConditionsBindingModel>

multipart/form-data

Sample:

--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="MprnNumber"

sample string 1
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="GasSmartMeterInstalled"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="MpanNumber"

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="ElectricitySmartMeterInstalled"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="GasMainsConnectionToo"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SuppliersTermsAndConditionsAreAccepted"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="HasMedicalConditionOrIndividualRequirement"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SpecialNeedsId"

1
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SpecialNeedsList[0]"

64
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SpecialNeedsList[1]"

64
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Language"

sample string 8
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="HappyToReceiveCreditCheck"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="HappyWithNpowerTerms"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="HappyToHaveDebtInformationAccessed"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="HasElectricityDebt"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="HasGasDebt"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SupplierMaySendImportantAccountChangesViaEmail"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="EmailUpdatesByMyUtilitygenius"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="PreferredSwitchDate"

2025-10-27T20:11:44.5826628+00:00
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="OnlinePassword"

sample string 16
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="OnlinePasswordConfirmation"

sample string 17
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="EonRewardsWanted"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="EonPriceAlertsWanted"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="EonPaperlessBillingWanted"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="IsSharedInfo"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="BillingPreference"

Paper
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="PrePaymentMeterId"

22
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="TescoClubCardNumber"

sample string 23
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CoOperativeMembershipNumber"

sample string 24
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="InterestedInJoiningTheCoOperative"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="ReferralId"

26
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="ReferralOption"

sample string 27
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SupplierMaySendRemindersAndUpdatesViaTelephoneAboutAccount"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SupplierMaySendRemindersAndUpdatesViaEmailAboutAccount"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SupplierMaySendUpdatesThatMayBeOfInterestViaDayPhone"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SupplierMaySendUpdatesThatMayBeOfInterestViaEveningPhone"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SupplierMaySendUpdatesThatMayBeOfInterestViaMobilePhone"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SupplierMaySendUpdatesThatMayBeOfInterestViaSms"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SupplierMaySendUpdatesThatMayBeOfInterestViaEmail"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SupplierMaySendUpdatesThatMayBeOfInterestViaPost"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SupplierMaySendUpdatesThatMayBeOfInterestViaFaceToFace"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SupplierMaySendUpdatesThatMayBeOfInterestViaIVM"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CampaignCode"

sample string 38
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="YesIamOnAGreenDeal"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="OvoFoundationOption"

NoDonation
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="OvoSecurityQuestion"

WhatWouldBeYourSuperpowerIfYouHadOne
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="OvoSecurityAnswer"

sample string 40
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CommunicationPreferrenceOverride"

None
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="AllUpdatesRemindersAndThirdPartyOverride"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="AllUpdatesRemindersOverride"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="IsHappyToBeAutoSwitched"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="EnsureAllAutoSwitchOptions"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CommunityProgrammeReference"

sample string 43
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="IsPaper"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="consent1"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="consent2"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="consent3"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SwitchAfterCoolingOfPeriod"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="PreferredCommunicationMethod"

sample string 45
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="PreferredCommunicationFormat"

sample string 46
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="ThreeMonthsOrLess"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Cot"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SwitchKey"

sample string 49
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="IsTou"

True
--MultipartDataMediaFormatterBoundary1q2w3e--

Response Information

Resource Description

Object

None.

Response Formats

application/json, text/json

Sample:

{}

application/xml, text/xml

Sample:

<z:anyType xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:z="http://schemas.microsoft.com/2003/10/Serialization/" />

multipart/form-data

Sample:

--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name=""

System.Object
--MultipartDataMediaFormatterBoundary1q2w3e--