Step 3: Get Supported Utility Providers

Purpose: Get a list of providers supported by UtilityID for a specific country.

User-experience: Use this endpoint to show your end-user all the supported providers in a country. They will need to pick their utility provider before proceeding with the rest of the UtilityID workflow.

Sample Request

GET /utilityid/v1/providers?countryCode=CA HTTP/1.1
Host: <<endpointLink>>
Authorization: Basic <auth>
Content-Type: multipart/form-data;

Parameters

  • countryCode - country for which providers need to be retrieved
    • Required
    • Type: string; query parameter

Sample Response

[
    "Access Gas Services",
    "BC Hydro",
    "Bluewater Power Distribution Corporation",
    "Brantford Power, Ontario",
    "Bruce Power Direct, Ontario",
    "City of Barrie, Ontario",
    "City of Brantford, Ontario",
    "City of Cold Lake, Alberta",
    "City of Edmundston, New Brunswick",
    "City of Medicine Hat, Alberta, Canada",
    "City of Nanaimo, British Columbia",
    "City of Spruce Grove, Alberta",
    "ENWIN",
    "FortisBC",
    "Gazifére, Québec",
    "Greater Sudbury Utilities (GSU)",
    "Halton Hills Hydro",
    "Hydro One",
    "InnPower, Ontario",
    "London Hydro",
    "Newfoundland Power",
    "Newmarket Hydro",
    "Niagara on-the-Lake Hydro, Ontario",
    "North Bay Hydro Community Power, Ontario",
    "Orillia Power Corporation",
    "PUC Services Incorporated",
    "Pacific Northern Gas Limited (PNG)",
    "Renfrew Hydro, Ontario",
    "Rideau St. Lawrence Distribution Inc., Ontario",
    "Township of Centre Wellington, Ontario",
    "TransAlta",
    "Union Gas (Enbridge)",
    "Veridian Connections, Ontario",
    "Énergie NB Power, New Brunswick"
]

Sample User-Experience

600