Use this file to discover all available pages before exploring further.
This step collects lets customer to select their energy provider from a pre-populated list. If their provider isn’t listed, they can manually enter its name. This step allows the service to target the correct upstream provider for tariff retrieval.
1
From the list
Returns the list of energy providers that serve the postal address provided earlier. Customer can select their current provider. If customers find their provider missing from the list, they can select the PROVIDER_MISSING action.
When you POST the response, Connect may return any of these validation errors:
Error Code
Error Description
provider_id_missing
Provider ID is required.
provider_not_found
Provider ID prv_XX not found.
provider_id_invalid
Provider ID prv_XX is not available at your address (XX).
data_json_invalid
Data does not conform to the JSON schema.
2
Manual entry
In the rare event that a provider’s name was not in the list on the previous page, the customer can indicate this and enter the name of their provider manually.
We advise you to render the postal_address object on the page and include an action button that will enable the customer to change their address - often, the provider is missing from the list because the address is wrong.
