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
NameDescriptionTypeAdditional 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-04-06T05:05:08.2240371+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-04-06T05:05:08.2240371+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-04-06T05:05:08.2240371+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--