Account

Registration, configuration, and general account management

APIDescription
GET request/Account/User-Info

Gets user information.

POST request/Account/Change-Password

Changes the password.

POST request/Account/Register

Register for Genius Service. Registration is not complete unless we approve your request origin. If your request origin is not approved within 24 hours please contact us.

Address

Provides accurate and up-to-date data on addresses

APIDescription
GET request/Address/List/v1

Gets a filtered list of addresses.

GET request/Address/List/v2

Gets a filtered list of addresses.

GET request/Address/Postcode/Ready/Supplier

Determines if a current residential postcode (by supplier) is ready for genius switch processing

GET request/Address/Postcode/Ready

Determines if a current residential postcode is ready for genius switch processing

GET request/Address/Postcode

Gets the postcode for a particular address type

POST request/Address/List/v1

Gets a filtered list of addresses.

POST request/Address/List/v2

Gets a filtered list of addresses.

POST request/Address/Postcode

Gets the postcode for a particular address type

POST request/Address/Postcode/Ready

Determines if a current residential postcode is ready for genius switch processing

POST request/Address/Postcode/Ready/Supplier

Determines if a current residential postcode (by supplier) is ready for genius switch processing

Customer

General management of customers

APIDescription
POST request/Customer/Info

Gets info about a Registered Customer.

POST request/Customer/New

Creates and Registers a new Customer. If the First Name and Last Name is NOT unique, then the email address must be.

Ppp

Personal Projection Plan (Ppp) for each tariff

APIDescription
POST request/Ppp

Gets the Personal Projection Plan (Ppp) for a specific tariff. If OnCurrentTariff, ProposedPayMethod and TariffId will be overridden with the appropriate values.

Results

Supplier and Tariff options for a Genius Switch

APIDescription
POST request/Results/Detail

Gets a collection of possible Tariffs - in detail - a customer can switch to. If a non-compulsory Body Parameter is NOT specified, the results shown will presume that the non-compulsory Body Parameter is NOT to be taken into account and that only the default behaviour should apply. The default behaviour is that CalculateSavingsFromPreviousTwelveMonthsCost is false

POST request/Results/Supplier/Detail

Gets all possible tariffs a customer can switch to based on supplier with detail. If a non-compulsory Body Parameter is NOT specified, the results shown will presume that the non-compulsory Body Parameter is NOT to be taken into account and that only the default beaviour should apply. The default behaviour is that CalculateSavingsFromPreviousTwelveMonthsCost is false

Suppliers

Supplier information for a prospective Genius Switch customer

APIDescription
GET request/Suppliers/List

No documentation available.

GET request/Suppliers

Gets a list of possible suppliers a customer can switch from.

POST request/Suppliers/List

No documentation available.

POST request/Suppliers

Gets a list of possible suppliers a customer can switch from.

SwitchPro

Professional genius switching service with option of complete control over layout and presentation to target audience

APIDescription
POST request/Switch/Pro/Complete

Completes a switch.

POST request/Switch/Pro/Detail/Direct-Debit-Days

Returns "Direct Debit Days" applicable for a particular switch.

POST request/Switch/Pro/Detail/Employment-Statuses

Returns "Employment Statuses" applicable for a particular switch.

POST request/Switch/Pro/Detail/Pre-Payment-Meters

Returns "Pre Payment Meters" applicable for a particular switch.

POST request/Switch/Pro/Detail/Referrals

Returns "Referrals" applicable for a particular switch.

POST request/Switch/Pro/Detail/Residential-Statuses

Returns "Residential Statuses" applicable for a particular switch.

POST request/Switch/Pro/Detail/Special-Needs

Returns "Special Needs" applicable for a particular switch.

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

Returns the required list of terms and conditions applicable for a particular switch.

POST request/Switch/Pro/Detail/Titles

Returns "Titles" applicable for a particular switch.

POST request/Switch/Pro/Info/Address

Returns "Address Info" present about a particular switch.

POST request/Switch/Pro/Info/Address/Switch-Postcode

Returns the energy supply postcode for the address where a switch will take place.

POST request/Switch/Pro/Info/Bank

Returns "Bank Info" present about a particular switch.

POST request/Switch/Pro/Info/Personal

Returns "Personal Info" present about a particular switch.

POST request/Switch/Pro/Info/Switch-Plan

Returns "General Info" present about a particular switch.

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

Returns "Terms and Conditions Info" present about a particular switch.

POST request/Switch/Pro/Key

Gets a switch key required to complete a customised switch.

POST request/Switch/Pro/Update/Address

Adds/Updates address details for a customer's switch.

POST request/Switch/Pro/Update/Bank

Adds/Updates bank details for a customer's switch. If IsCertainOfDataCorrectness, Bank Validation rules - and in turn confirmation of DetailsBankBindingModel correctness - would not apply.

POST request/Switch/Pro/Update/Personal

Adds/Updates personal details for a customer's switch.

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.

Switch

General management of customer switches

APIDescription
POST request/Switch/Dual-Consolidated

Sets up an unregistered Customer looking to switch from a Dual Consolidated tariff.

POST request/Switch/Dual-Distinct

Sets up an unregistered Customer looking to switch from a Dual Distinct tariff.

POST request/Switch/Electricity

Sets up an unregistered Customer looking to switch from an Electricity only tariff.

POST request/Switch/Gas

Sets up an unregistered Customer looking to switch from a Gas only tariff.

POST request/Switch/Related

Adds additional information that may be of interest on a particular switch.

POST request/Switch/State

Adds additional information that may be of interest on a particular switch.

SwitchTemplate

Template genius switching service with Pre-configured layout of content to target audience

APIDescription
GET request/Switch/Template/Form

Loads a standard form for customer completion.

GET request/Switch/Template/Key

Gets a switch key required to complete a standard switch form.

POST request/Switch/Template/Form

Loads a standard form for customer completion.

POST request/Switch/Template/Key

Gets a switch key required to complete a standard switch form.

SwitchUtilities

General Help for a genius switch

APIDescription
GET request/Switch/Utilities/ReferrerBranches

Returns "Referrer Branches" applicable for any offline switch.

GET request/Switch/Utilities/ReferrerBranches/Authorised

Returns "Referrer Branches" authorised for a particular switch.

GET request/Switch/Utilities/Titles/Default

Returns default "Titles" applicable for any switch.

POST request/Switch/Utilities/ReferrerBranches

Returns "Referrer Branches" applicable for any offline switch.

POST request/Switch/Utilities/ReferrerBranches/Authorised

Returns "Referrer Branches" authorised for a particular switch.

POST request/Switch/Utilities/Titles/Default

Returns default "Titles" applicable for any switch.

Tariffs

Tariff information for a prospective Genius Switch customer

APIDescription
GET request/Tariffs/Tariff/Information

Gets additional information specific to a particular tariff.

GET request/Tariffs

Gets a list of possible tariffs a customer can switch from.

POST request/Tariffs

Gets a list of possible tariffs a customer can switch from.

POST request/Tariffs/Tariff/Information

Gets additional information specific to a particular tariff.

Til

Tariff Information Label (Til) for each tariff

APIDescription
POST request/Til

Gets the Tariff Information Label (Til) for a specific tariff. If OnCurrentTariff, ProposedPayMethod and TariffId will be overridden with the appropriate values.

POST request/Til/Direct

Gets the Tariff Information Label (Til) for a specific tariff.