POST request/Switch/Pro/Update/Personal

Returns a set of specific personal detail captures for a consumer switching energy to either provide or has already provided as mandatory and/or optional. Personal details can be updated dependent on how the consumer switching journey is built.

Request Information

URI Parameters

None.

Body Parameters

The details personal binding model.

DetailsPersonalBindingModel

Name	Type	Additional information
DateOfBirth	date	Required Data type: Date
DayTimePhone	string	Required Data type: PhoneNumber
EmailAddress	string	Required Data type: EmailAddress
EmploymentStatusId	integer	None.
EveningPhone	string	Data type: PhoneNumber
FirstName	string	Required Matching regular expression pattern: ^[a-zA-Z\s]+$ Min length: 1 String length: inclusive between 0 and 100
IsTou	boolean	None.
LastName	string	Required Matching regular expression pattern: ^[a-zA-Z\s]+$ Min length: 1 String length: inclusive between 0 and 100
MobilePhone	string	Data type: PhoneNumber
SwitchKey	string	Required Max length: 50 Min length: 1
TitleId	integer	Required Range: inclusive between 0 and 255

Request Formats

application/json, text/json

Sample:

{
  "titleId": 1,
  "firstName": "sample string 2",
  "lastName": "sample string 3",
  "dateOfBirth": "2025-10-27T20:56:17.676207+00:00",
  "emailAddress": "sample string 4",
  "dayTimePhone": "sample string 5",
  "eveningPhone": "sample string 6",
  "mobilePhone": "sample string 7",
  "employmentStatusId": 1,
  "switchKey": "sample string 8",
  "isTou": true
}

application/xml, text/xml

Sample:

<DetailsPersonalBindingModel 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 8</SwitchKey>
  <DateOfBirth>2025-10-27T20:56:17.676207+00:00</DateOfBirth>
  <DayTimePhone>sample string 5</DayTimePhone>
  <EmailAddress>sample string 4</EmailAddress>
  <EmploymentStatusId>1</EmploymentStatusId>
  <EveningPhone>sample string 6</EveningPhone>
  <FirstName>sample string 2</FirstName>
  <LastName>sample string 3</LastName>
  <MobilePhone>sample string 7</MobilePhone>
  <TitleId>1</TitleId>
</DetailsPersonalBindingModel>

multipart/form-data

Sample:

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

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

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="LastName"

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

2025-10-27T20:56:17.6762070+00:00
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="EmailAddress"

sample string 4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="DayTimePhone"

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

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

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

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

sample string 8
--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--