POST request/Switch/v2/Dual-Distinct

Postcode and address upfront data capture for consumer energy quote and switching who is on a Dual Distinct fuel set up which means the property has access to both energy types with separate gas and electricity providers.

Request Information

URI Parameters

None.

Body Parameters

BillDualDistinctBindingModelVersionTwo

Name	Type	Additional information
AccountManagementOnline	OnlineTariffOption	None.
Address	AddressBindingModel	None.
BillConsumptionIsEstimated	boolean	Required
CustomerId	integer	None.
Economy7Percentage	decimal number	Required Range: inclusive between 0 and 100
ElectricityConsumptionExceedsGasConsumption	boolean	None.
ElectricityCurrentCostEstimated	decimal number	Data type: Currency Range: inclusive between 0 and 9000
ElectricityCurrentPayMethod	PayMethod	Required
ElectricityCurrentUsageEstimated	integer	Range: inclusive between 0 and 75000
ElectricityTariffId	integer	Required
ElectricityTariffValidToDate	date	None.
ElectricityUtilityPeriod	UtilityPeriod	Required
EmailAddress	string	Data type: EmailAddress
GasCurrentCostEstimated	decimal number	Data type: Currency Range: inclusive between 0 and 9000
GasCurrentPayMethod	PayMethod	Required
GasCurrentUsageEstimated	integer	Range: inclusive between 0 and 200000
GasTariffId	integer	Required
GasTariffValidToDate	date	None.
GasUtilityPeriod	UtilityPeriod	Required
IsHappyToBeAutoSwitched	boolean	None.
Postcode	string	Required Data type: PostalCode
ReferrerBranchCode	string	Required Max length: 100
SwitchOwnerReference	string	Max length: 50
SwitchType	SwitchType	Required

Request Formats

application/json, text/json

Sample:

{
  "electricityConsumptionExceedsGasConsumption": true,
  "electricityTariffId": 2,
  "electricityTariffValidToDate": "2025-10-27T23:44:39.2244802+00:00",
  "electricityCurrentPayMethod": "MonthlyDirectDebit",
  "electricityUtilityPeriod": "Annually",
  "economy7Percentage": 3.0,
  "electricityCurrentCostEstimated": 1.0,
  "electricityCurrentUsageEstimated": 1,
  "gasTariffId": 4,
  "gasTariffValidToDate": "2025-10-27T23:44:39.2244802+00:00",
  "gasCurrentPayMethod": "MonthlyDirectDebit",
  "gasUtilityPeriod": "Annually",
  "gasCurrentCostEstimated": 1.0,
  "gasCurrentUsageEstimated": 1,
  "address": {
    "addressLine1": "sample string 1",
    "addressLine2": "sample string 2",
    "town": "sample string 3",
    "county": "sample string 4",
    "postCode": "sample string 5",
    "mpan": "sample string 6",
    "mprn": "sample string 7"
  },
  "postcode": "sample string 5",
  "switchType": "DualConsolidatedToDualConsolidated",
  "emailAddress": "sample string 6",
  "accountManagementOnline": "Tentative",
  "referrerBranchCode": "sample string 7",
  "billConsumptionIsEstimated": true,
  "isHappyToBeAutoSwitched": true,
  "customerId": 1,
  "switchOwnerReference": "sample string 10"
}

application/xml, text/xml

Sample:

<BillDualDistinctBindingModelVersionTwo xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/MyUtilityGenius.Api.Domain.Default.BindingModel">
  <AccountManagementOnline>Tentative</AccountManagementOnline>
  <BillConsumptionIsEstimated>true</BillConsumptionIsEstimated>
  <CustomerId>1</CustomerId>
  <EmailAddress>sample string 6</EmailAddress>
  <IsHappyToBeAutoSwitched>true</IsHappyToBeAutoSwitched>
  <Postcode>sample string 5</Postcode>
  <ReferrerBranchCode>sample string 7</ReferrerBranchCode>
  <SwitchOwnerReference>sample string 10</SwitchOwnerReference>
  <SwitchType>DualConsolidatedToDualConsolidated</SwitchType>
  <Address>
    <AddressLine1>sample string 1</AddressLine1>
    <AddressLine2>sample string 2</AddressLine2>
    <County>sample string 4</County>
    <Mpan>sample string 6</Mpan>
    <Mprn>sample string 7</Mprn>
    <PostCode>sample string 5</PostCode>
    <Town>sample string 3</Town>
  </Address>
  <Economy7Percentage>3</Economy7Percentage>
  <ElectricityConsumptionExceedsGasConsumption>true</ElectricityConsumptionExceedsGasConsumption>
  <ElectricityCurrentCostEstimated>1</ElectricityCurrentCostEstimated>
  <ElectricityCurrentPayMethod>MonthlyDirectDebit</ElectricityCurrentPayMethod>
  <ElectricityCurrentUsageEstimated>1</ElectricityCurrentUsageEstimated>
  <ElectricityTariffId>2</ElectricityTariffId>
  <ElectricityTariffValidToDate>2025-10-27T23:44:39.2244802+00:00</ElectricityTariffValidToDate>
  <ElectricityUtilityPeriod>Annually</ElectricityUtilityPeriod>
  <GasCurrentCostEstimated>1</GasCurrentCostEstimated>
  <GasCurrentPayMethod>MonthlyDirectDebit</GasCurrentPayMethod>
  <GasCurrentUsageEstimated>1</GasCurrentUsageEstimated>
  <GasTariffId>4</GasTariffId>
  <GasTariffValidToDate>2025-10-27T23:44:39.2244802+00:00</GasTariffValidToDate>
  <GasUtilityPeriod>Annually</GasUtilityPeriod>
</BillDualDistinctBindingModelVersionTwo>

multipart/form-data

Sample:

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

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

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

2025-10-27T23:44:39.2244802+00:00
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="ElectricityCurrentPayMethod"

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

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

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

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

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

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

2025-10-27T23:44:39.2244802+00:00
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="GasCurrentPayMethod"

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

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

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

1
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Address.AddressLine1"

sample string 1
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Address.AddressLine2"

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Address.Town"

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Address.County"

sample string 4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Address.PostCode"

sample string 5
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Address.Mpan"

sample string 6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Address.Mprn"

sample string 7
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Postcode"

sample string 5
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SwitchType"

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

sample string 6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="AccountManagementOnline"

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

sample string 7
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="BillConsumptionIsEstimated"

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

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

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

sample string 10
--MultipartDataMediaFormatterBoundary1q2w3e--

Response Information

Resource Description

CustomerDtoResponse

Name	Type	Additional information
ApiVersion	string	None.
GeniusSwitchDto	GeniusSwitchDto	None.
Uri	string	None.

Response Formats

application/json, text/json

Sample:

{
  "apiVersion": "sample string 1",
  "uri": "sample string 2",
  "geniusSwitchDto": {
    "switchId": 1
  }
}

application/xml, text/xml

Sample:

<CustomerDtoResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/MyUtilityGenius.Api.Models.DtoResponse">
  <ApiVersion>sample string 1</ApiVersion>
  <GeniusSwitchDto xmlns:d2p1="http://schemas.datacontract.org/2004/07/MyUtilityGenius.Api.Models.Dto">
    <SwitchId xmlns="http://schemas.datacontract.org/2004/07/MyUtilityGenius.Api.Domain.Default.Switch">1</SwitchId>
  </GeniusSwitchDto>
  <Uri>sample string 2</Uri>
</CustomerDtoResponse>

multipart/form-data

Sample:

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

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

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="GeniusSwitchDto.SwitchId"

1
--MultipartDataMediaFormatterBoundary1q2w3e--