Skip to content

Utilities Register Integration Guide

This guide explains how to access GBGroup's MatchCode 360 Utilities Register web service product using their Identity Management Platform (IdM), available via SOAP web services. 

The fundamentals of integrating with the service are described here: Integration Fundamentals 

Please note: Wherever <LatestWSDLVersion> is shown in Example Code below, please replace this with GlobalServices21a.wsdl.

Matchcode Utilities Register Web Service Product Information

The Matchcode Utilities Register Web Service service allows searching on UK Gas and Electricity Meter Data.

The Matchcode Utilities Register web service products are available via the Identity Management ExecuteCapture web service method.

Utilities Register Capture


Method: ExecuteCapture

The ExecuteCapture method takes in a ExecuteCaptureRequest data structure, which contains all the information neccessary to carry out the request.

Input Details

Type: ExecuteCaptureRequest

Field Name Type Description
securityHeader SecurityHeader The username and authentication token used to access the system.
profileRequest ProfileRequestCapture Details of the request


The SecurityHeader structure holds security data to access products and services in the IdM Platform.

The ProfileRequestCapture structure contains the criteria to identify the target product being called and the search data for the product request.

Within the profileRequest element, the profileGuid element should contain the GUID value listed below:

Profile GUID
Matchcode360 Utilities Register 942A500C-F57F-4C7B-9C1D-0F8246CA3890
Address Search Criteria

The address search criteria should be entered into the IdmDataSearchAddress data structure, which is located within the input details as follows:

ExecuteCapture → ProfileRequestCaptureProfileRequestCaptureDataIdMDataSearchAddress

As well as searches on standard address elements, searches can be made on Electricity MPAN, Gas MPRN or either electricity or gas meter serial numbers.

To do this use the IdMDataSearchAddress → IdmDataSearchUtilitiesInformation structure.

Alternative Search Criteria

Along with the standard address search criteria, this service supports address searching by one of the address identifiers listed below.

This search criteria is specified by using the additionalItems property of the search address. To carry out a search with one of these identifiers, a key-value pair must be included in the additional items property, with the key being the identifier and the value being the search value. Only one identifier can be used in a search, if more than one are specified the others will be ignored.

This alternative search criteria overrides the standard address search criteria, which will be ignored if a valid identifier is provided in the IDM request.

Key Description
UPRN Unique Property Reference Number from OS AddressBase (Utilities Premium Service Only)
UDPRN Royal Mail unique delivery point reference number (Utilities Standard Service Only)
OWNINGUDPRN Unique Delivery Point Reference Number of owning Delivery Point for Multi Residence properties (Utilities Standard Service Only)
UMRRN Unique Multiple Residence Reference Number for Multi Residence properties (Utilities Standard Service Only)
Utilities Register Sample XML Input

The following XML sample demonstrates a request data object containing a search address.

<!-- request input data - search address -->
<req:requestdata>
   <req:address>
      <data:organisation>gb group plc</data:organisation>
      <data:postcode>ch4 9gb</data:postcode>
      <data:countrycode>gbr</data:countrycode>
    </req:address>
 </req:requestdata>
{
  "requestdata": {
    "address": {
      "organisation": "gb group plc",
      "postcode": "ch4 9gb",
      "countrycode": "gbr"
    }
  }
}

The following XML sample demonstrates a request data object containing a search on an electricity MPAN.

<!-- request input data - search mpan-->
<req:requestdata>
   <req:address>
      <data:utilitiesinformation>
         <data:mprn></data:mprn>
         <data:gasmeternumber></data:gasmeternumber>
         <data:mpan>1610000344972</data:mpan>
         <data:electricitymeternumber></data:electricitymeternumber>
       </data:utilitiesinformation>
    </req:address>
 </req:requestdata>
{
  "requestdata": {
   "address": {
    "utilitiesinformation": {
       "mprn": "",
       "gasmeternumber": "",
       "mpan": "1610000344972",
       "electricitymeternumber": ""
    }
  }
}

Output Details

The results of the Utilities Register web service search are returned in a ProfileResponseDetails structure with a ProfileResponseDetail.responseType of 'CAPTURE'.

The ProfileResponseDetails structure contains a single CaptureResponse data structure which holds an array of IdmDataAddress records containing the returned address data.

ExecuteCaptureResponse > ProfileResponse [0] > ProfileResponseDetails [0] > CaptureResponse > CaptureResponseData > IdmDataAddress [n]

Utilities Register Information

The Utilities Register specific business information is returned in the IdmDataAddress → IdmDataUtilitiesInformation structure

Additional Information

Additional information may be returned in the additionalItems of the IdmDataAddress.

Below is a list of expected additional data fields:

Key Mnemonic Key Value Description
DATASOURCE UTILITIES_REGISTER or UTILITIES_REGISTER_P Source of the address information (Utilities Register Standard or Utilities Register Premium

Sample XML Response

<mes:profileresponse>
            <req:profileheader>
               <req:profileguid>942a500c-f57f-4c7b-9c1d-0f8246ca3890</req:profileguid>
               <req:profilename>matchcode360 utilities register</req:profilename>
               <req:transactionguid>bdc233b7-96ae-40a2-a409-b039b31118d1</req:transactionguid>
               <req:transactiontimestamp>2016-08-12t15:03:27.469+01:00</req:transactiontimestamp>
               <req:profilestatus>success</req:profilestatus>
            </req:profileheader>
            <req:profileresponsedetails>
               <req:transactionguid>3c5959ea-9137-4558-b801-02b7afa1f448</req:transactionguid>
               <req:componentname>matchcode utilities register</req:componentname>
               <req:componentstatus>success</req:componentstatus>
               <req:componentaction>verify</req:componentaction>
               <req:responsetype>capture</req:responsetype>
               <req:notes>[]</req:notes>
               <req:invoice>
                  <req:invoicelist>
                     <req:billinginformationguid>034d7965-100d-401f-9240-a13d9fee5928</req:billinginformationguid>
                     <req:billingpoints>0</req:billingpoints>
                  </req:invoicelist>
                  <req:invoicelist>
                     <req:billinginformationguid>539ec977-f1fb-44ec-98e4-9da9727d7a66</req:billinginformationguid>
                     <req:billingpoints>0</req:billingpoints>
                  </req:invoicelist>
                  <req:invoicelist>
                     <req:invoiceguid>53cc104b-c182-4eed-addf-33ab1c64822a</req:invoiceguid>
                     <req:billinginformationguid>947b88ff-9bc1-40a0-926d-05a468fc1839</req:billinginformationguid>
                     <req:billingpoints>1</req:billingpoints>
                     <req:datasetinvoices>
                        <req:datasetcode>utilities_register</req:datasetcode>
                        <req:billingpoints>1</req:billingpoints>
                        <req:recordsreturned>11</req:recordsreturned>
                        <req:datalicenceguid>947b88ff-9bc1-40a0-926d-05a468fc1839</req:datalicenceguid>
                     </req:datasetinvoices>
                  </req:invoicelist>
               </req:invoice>
               <req:captureresponse>
                  <req:resultstatus>multiple</req:resultstatus>
                  <req:recordsreturned>11</req:recordsreturned>
                  <req:moredata>false</req:moredata>
                  <req:totalrecordcount>11</req:totalrecordcount>
                  <req:totalpages>1</req:totalpages>
                  <req:matchscore>0</req:matchscore>
                  <req:matchlevel>na</req:matchlevel>
                  <req:outputstatus>notmatched</req:outputstatus>
                  <req:fieldstatus>55555555</req:fieldstatus>
                  <req:responsecount>1</req:responsecount>
                  <req:response>
                     <req:address>
                        <data:organisation>countess of chester hospital</data:organisation>
                        <data:street>liverpool road</data:street>
                        <data:town>chester</data:town>
                        <data:postcode>ch2 1ul</data:postcode>
                        <data:department>mostyn lodge</data:department>
                        <data:buildingname>countess of chester health park</data:buildingname>
                        <data:stateregion>cheshire</data:stateregion>
                        <data:countrycode>gbr</data:countrycode>
                        <data:dpszipplus>9z8</data:dpszipplus>
                        <data:formattedaddress>countess of chester hospital mostyn lodge,countess of chester health park,liverpool road,chester,cheshire,ch2 1ul</data:formattedaddress>
                        <data:additionalitems>
                           <data:item>
                              <data:key>datasource</data:key>
                              <data:value>utilities_register</data:value>
                           </data:item>
                        </data:additionalitems>
                        <data:utilitiesinformation>
                           <data:fueltype>gas</data:fueltype>
                           <data:gasinformation>
                              <data:lguf>1</data:lguf>
                              <data:originalpostcode>ch2 1ul</data:originalpostcode>
                              <data:meterpointcount>1</data:meterpointcount>
                              <data:meterpoint>
                                 <data:mprn>0044619607</data:mprn>
                                 <data:metercount>1</data:metercount>
                                 <data:meter>
                                    <data:serialnumber>m040k0029812d6</data:serialnumber>
                                 </data:meter>
                              </data:meterpoint>
                           </data:gasinformation>
                        </data:utilitiesinformation>
                     </req:address>
                     <req:address>
                        <data:organisation>countess of chester hospital</data:organisation>
                        <data:street>liverpool road</data:street>
                        <data:town>chester</data:town>
                        <data:postcode>ch2 1ul</data:postcode>
                        <data:buildingname>countess of chester health park</data:buildingname>
                        <data:stateregion>cheshire</data:stateregion>
                        <data:countrycode>gbr</data:countrycode>
                        <data:dpszipplus>1ah</data:dpszipplus>
                        <data:formattedaddress>countess of chester hospital,countess of chester health park,liverpool road,chester,cheshire,ch2 1ul</data:formattedaddress>
                        <data:additionalitems>
                           <data:item>
                              <data:key>datasource</data:key>
                              <data:value>utilities_register</data:value>
                           </data:item>
                        </data:additionalitems>
                        <data:rmudprn>04584600</data:rmudprn>
                        <data:utilitiesinformation>
                           <data:fueltype>both</data:fueltype>
                           <data:gasinformation>
                              <data:lguf>1</data:lguf>
                              <data:originalpostcode>ch2 1ul</data:originalpostcode>
                              <data:meterpointcount>4</data:meterpointcount>
                              <data:meterpoint>
                                 <data:mprn>0078005206</data:mprn>
                                 <data:metercount>1</data:metercount>
                                 <data:meter>
                                    <data:serialnumber>m040k0030412d6</data:serialnumber>
                                 </data:meter>
                              </data:meterpoint>
                              <data:meterpoint>
                                 <data:mprn>8904179407</data:mprn>
                                 <data:metercount>1</data:metercount>
                                 <data:meter>
                                    <data:serialnumber>m0650d459105b7</data:serialnumber>
                                 </data:meter>
                              </data:meterpoint>
                              <data:meterpoint>
                                 <data:mprn>9114012204</data:mprn>
                                 <data:metercount>1</data:metercount>
                                 <data:meter>
                                    <data:serialnumber>m065k0662612d6</data:serialnumber>
                                 </data:meter>
                              </data:meterpoint>
                              <data:meterpoint>
                                 <data:mprn>0077997606</data:mprn>
                                 <data:metercount>1</data:metercount>
                                 <data:meter>
                                    <data:serialnumber>g4k00064461101</data:serialnumber>
                                 </data:meter>
                              </data:meterpoint>
                           </data:gasinformation>
                           <data:electricityinformation>
                              <data:originalpostcode>ch2 1ul</data:originalpostcode>
                              <data:meterpointcount>1</data:meterpointcount>
                              <data:meterpoint>
                                 <data:mpan>1300035359121</data:mpan>
                                 <data:gspid>_d</data:gspid>
                                 <data:distributorid>13</data:distributorid>
                                 <data:profiletype>00</data:profiletype>
                                 <data:timeswitchcode>845</data:timeswitchcode>
                                 <data:linelossfactorid>515</data:linelossfactorid>
                                 <data:energisationstatus>e</data:energisationstatus>
                                 <data:energisationeffectivefromdate>
                                    <data:day>14</data:day>
                                    <data:month>4</data:month>
                                    <data:year>2016</data:year>
                                 </data:energisationeffectivefromdate>
                                 <data:metercount>4</data:metercount>
                                 <data:meter>
                                    <data:serialnumber>n507j20880</data:serialnumber>
                                    <data:type>h</data:type>
                                 </data:meter>
                                 <data:meter>
                                    <data:serialnumber>n507j20878</data:serialnumber>
                                    <data:type>h</data:type>
                                 </data:meter>
                                 <data:meter>
                                    <data:serialnumber>n507j20877</data:serialnumber>
                                    <data:type>h</data:type>
                                 </data:meter>
                                 <data:meter>
                                    <data:serialnumber>n507j20879</data:serialnumber>
                                    <data:type>h</data:type>
                                 </data:meter>
                              </data:meterpoint>
                           </data:electricityinformation>
                        </data:utilitiesinformation>
                     </req:address>
                     <req:address>
                        <data:street>liverpool road</data:street>
                        <data:town>chester</data:town>
                        <data:postcode>ch2 1ul</data:postcode>
                        <data:buildingname>eastway house</data:buildingname>
                        <data:stateregion>cheshire</data:stateregion>
                        <data:countrycode>gbr</data:countrycode>
                        <data:dpszipplus>9z8</data:dpszipplus>
                        <data:formattedaddress>eastway house,liverpool road,,chester,cheshire,ch2 1ul</data:formattedaddress>
                        <data:additionalitems>
                           <data:item>
                              <data:key>datasource</data:key>
                              <data:value>utilities_register</data:value>
                           </data:item>
                        </data:additionalitems>
                        <data:utilitiesinformation>
                           <data:fueltype>electricity</data:fueltype>
                           <data:electricityinformation>
                              <data:originalpostcode>ch2 1ul</data:originalpostcode>
                              <data:meterpointcount>1</data:meterpointcount>
                              <data:meterpoint>
                                 <data:mpan>1300010375090</data:mpan>
                                 <data:gspid>_d</data:gspid>
                                 <data:distributorid>13</data:distributorid>
                                 <data:profiletype>03</data:profiletype>
                                 <data:timeswitchcode>801</data:timeswitchcode>
                                 <data:linelossfactorid>201</data:linelossfactorid>
                                 <data:standardsettlementconfiguration>0393</data:standardsettlementconfiguration>
                                 <data:energisationstatus>e</data:energisationstatus>
                                 <data:energisationeffectivefromdate>
                                    <data:day>1</data:day>
                                    <data:month>4</data:month>
                                    <data:year>2012</data:year>
                                 </data:energisationeffectivefromdate>
                                 <data:metercount>1</data:metercount>
                                 <data:meter>
                                    <data:serialnumber>e12z110765</data:serialnumber>
                                    <data:type>rcamy</data:type>
                                 </data:meter>
                              </data:meterpoint>
                           </data:electricityinformation>
                        </data:utilitiesinformation>
                     </req:address>
                     <req:address>
                        <data:organisation>hospital energy centre countess of chester hospital</data:organisation>
                        <data:street>liverpool road</data:street>
                        <data:town>chester</data:town>
                        <data:postcode>ch2 1ul</data:postcode>
                        <data:buildingname>countess of chester health park</data:buildingname>
                        <data:stateregion>cheshire</data:stateregion>
                        <data:countrycode>gbr</data:countrycode>
                        <data:dpszipplus>9z8</data:dpszipplus>
                        <data:formattedaddress>hospital energy centre countess of chester hospital,countess of chester health park,liverpool road,chester,cheshire,ch2 1ul</data:formattedaddress>
                        <data:additionalitems>
                           <data:item>
                              <data:key>datasource</data:key>
                              <data:value>utilities_register</data:value>
                           </data:item>
                        </data:additionalitems>
                        <data:utilitiesinformation>
                           <data:fueltype>gas</data:fueltype>
                           <data:gasinformation>
                              <data:lguf>1</data:lguf>
                              <data:originalpostcode>ch2 1ul</data:originalpostcode>
                              <data:meterpointcount>1</data:meterpointcount>
                              <data:meterpoint>
                                 <data:mprn>9219904005</data:mprn>
                                 <data:metercount>1</data:metercount>
                                 <data:meter>
                                    <data:serialnumber>m1075d720809b7</data:serialnumber>
                                 </data:meter>
                              </data:meterpoint>
                           </data:gasinformation>
                        </data:utilitiesinformation>
                     </req:address>
                     <req:address>
                        <data:street>liverpool road</data:street>
                        <data:town>chester</data:town>
                        <data:postcode>ch2 1ul</data:postcode>
                        <data:buildingname>path lab</data:buildingname>
                        <data:stateregion>cheshire</data:stateregion>
                        <data:countrycode>gbr</data:countrycode>
                        <data:dpszipplus>9z8</data:dpszipplus>
                        <data:formattedaddress>path lab,liverpool road,,chester,cheshire,ch2 1ul</data:formattedaddress>
                        <data:additionalitems>
                           <data:item>
                              <data:key>datasource</data:key>
                              <data:value>utilities_register</data:value>
                           </data:item>
                        </data:additionalitems>
                        <data:utilitiesinformation>
                           <data:fueltype>gas</data:fueltype>
                           <data:gasinformation>
                              <data:lguf>1</data:lguf>
                              <data:originalpostcode>ch2 1ul</data:originalpostcode>
                              <data:meterpointcount>1</data:meterpointcount>
                              <data:meterpoint>
                                 <data:mprn>9106587507</data:mprn>
                                 <data:metercount>1</data:metercount>
                                 <data:meter>
                                    <data:serialnumber>m016a1694401a6</data:serialnumber>
                                 </data:meter>
                              </data:meterpoint>
                           </data:gasinformation>
                        </data:utilitiesinformation>
                     </req:address>
                     <req:address>
                        <data:street>liverpool road</data:street>
                        <data:town>chester</data:town>
                        <data:postcode>ch2 1ul</data:postcode>
                        <data:subbuilding>pinetum nursing home</data:subbuilding>
                        <data:buildingname>countess of chester health park</data:buildingname>
                        <data:stateregion>cheshire</data:stateregion>
                        <data:countrycode>gbr</data:countrycode>
                        <data:dpszipplus>9z8</data:dpszipplus>
                        <data:formattedaddress>pinetum nursing home,countess of chester health park,liverpool road,chester,cheshire,ch2 1ul</data:formattedaddress>
                        <data:additionalitems>
                           <data:item>
                              <data:key>datasource</data:key>
                              <data:value>utilities_register</data:value>
                           </data:item>
                        </data:additionalitems>
                        <data:utilitiesinformation/>
                     </req:address>
                     <req:address>
                        <data:street>liverpool road</data:street>
                        <data:town>chester</data:town>
                        <data:postcode>ch2 1ul</data:postcode>
                        <data:buildingname>st johns ambulance building</data:buildingname>
                        <data:stateregion>cheshire</data:stateregion>
                        <data:countrycode>gbr</data:countrycode>
                        <data:dpszipplus>9z8</data:dpszipplus>
                        <data:formattedaddress>st johns ambulance building,liverpool road,,chester,cheshire,ch2 1ul</data:formattedaddress>
                        <data:additionalitems>
                           <data:item>
                              <data:key>datasource</data:key>
                              <data:value>utilities_register</data:value>
                           </data:item>
                        </data:additionalitems>
                        <data:utilitiesinformation>
                           <data:fueltype>gas</data:fueltype>
                           <data:gasinformation>
                              <data:lguf>1</data:lguf>
                              <data:originalpostcode>ch2 1ul</data:originalpostcode>
                              <data:meterpointcount>1</data:meterpointcount>
                              <data:meterpoint>
                                 <data:mprn>8833875108</data:mprn>
                                 <data:metercount>1</data:metercount>
                                 <data:meter>
                                    <data:serialnumber>m016a0465612a6</data:serialnumber>
                                 </data:meter>
                              </data:meterpoint>
                           </data:gasinformation>
                        </data:utilitiesinformation>
                     </req:address>
                     <req:address>
                        <data:organisation>west cheshire nhs trust countess of chester hospital</data:organisation>
                        <data:street>liverpool road</data:street>
                        <data:town>chester</data:town>
                        <data:postcode>ch2 1ul</data:postcode>
                        <data:buildingname>countess of chester health park</data:buildingname>
                        <data:stateregion>cheshire</data:stateregion>
                        <data:countrycode>gbr</data:countrycode>
                        <data:dpszipplus>9z8</data:dpszipplus>
                        <data:formattedaddress>west cheshire nhs trust countess of chester hospital,countess of chester health park,liverpool road,chester,cheshire,ch2 1ul</data:formattedaddress>
                        <data:additionalitems>
                           <data:item>
                              <data:key>datasource</data:key>
                              <data:value>utilities_register</data:value>
                           </data:item>
                        </data:additionalitems>
                        <data:utilitiesinformation>
                           <data:fueltype>gas</data:fueltype>
                           <data:gasinformation>
                              <data:lguf>1</data:lguf>
                              <data:originalpostcode>ch2 1ul</data:originalpostcode>
                              <data:meterpointcount>1</data:meterpointcount>
                              <data:meterpoint>
                                 <data:mprn>0077983000</data:mprn>
                                 <data:metercount>1</data:metercount>
                                 <data:meter>
                                    <data:serialnumber>m0650d497913b7</data:serialnumber>
                                 </data:meter>
                              </data:meterpoint>
                           </data:gasinformation>
                        </data:utilitiesinformation>
                     </req:address>
                  </req:response>
               </req:captureresponse>
            </req:profileresponsedetails>
         </mes:profileresponse>
{
   "profileheader":    {
      "profileguid": "942a500c-f57f-4c7b-9c1d-0f8246ca3890",
      "profilename": "matchcode360 utilities register",
      "transactionguid": "8937b0dd-0601-4860-ad67-166cf7eae95b",
      "transactiontimestamp": "2016-08-12t15:01:39.356z",
      "profilestatus": "success"
   },
   "profileresponsedetails": [   {
      "transactionguid": "d14b1d09-ad67-4482-a628-de47e43d6876",
      "componentname": "matchcode utilities register",
      "componentstatus": "success",
      "componentaction": "verify",
      "responsetype": "capture",
      "notes": "[]",
      "invoice": {"invoicelist":       [
                  {
            "billinginformationguid": "034d7965-100d-401f-9240-a13d9fee5928",
            "billingpoints": 0,
            "datasetinvoices": []
         },
                  {
            "billinginformationguid": "539ec977-f1fb-44ec-98e4-9da9727d7a66",
            "billingpoints": 0,
            "datasetinvoices": []
         },
                  {
            "invoiceguid": "7ca61048-7401-46cc-88c6-65a9a3acae42",
            "billinginformationguid": "947b88ff-9bc1-40a0-926d-05a468fc1839",
            "billingpoints": 1,
            "datasetinvoices": [            {
               "datasetcode": "utilities_register",
               "billingpoints": 1,
               "recordsreturned": 11,
               "datalicenceguid": "947b88ff-9bc1-40a0-926d-05a468fc1839"
            }]
         }
      ]},
      "captureresponse":       {
         "resultstatus": "multiple",
         "recordsreturned": 11,
         "moredata": false,
         "totalrecordcount": 11,
         "totalpages": 1,
         "matchscore": 0,
         "matchlevel": "na",
         "outputstatus": "notmatched",
         "fieldstatus": "55555555",
         "responsecount": 1,
         "response": [         {
            "address": [    {
                  "organisation": "countess of chester hospital",
                  "street": "liverpool road",
                  "town": "chester",
                  "postcode": "ch2 1ul",
                  "department": "mostyn lodge",
                  "buildingname": "countess of chester health park",
                  "stateregion": "cheshire",
                  "countrycode": "gbr",
                  "dpszipplus": "9z8",
                  "formattedaddress": "countess of chester hospital mostyn lodge,countess of chester health park,liverpool road,chester,cheshire,ch2 1ul",
                  "additionalitems": {"item": [                  {
                     "key": "datasource",
                     "value": "utilities_register"
                  }]},
                  "groupedadditionalitems": [],
                  "utilitiesinformation":                   {
                     "fueltype": "gas",
                     "gasinformation":                      {
                        "lguf": "1",
                        "originalpostcode": "ch2 1ul",
                        "meterpointcount": 1,
                        "meterpoint": [                        {
                           "mprn": "0044619607",
                           "metercount": 1,
                           "meter": [{"serialnumber": "m040k0029812d6"}]
                        }]
                     }
                  }
               },
               {
                  "organisation": "countess of chester hospital",
                  "street": "liverpool road",
                  "town": "chester",
                  "postcode": "ch2 1ul",
                  "buildingname": "countess of chester health park",
                  "stateregion": "cheshire",
                  "countrycode": "gbr",
                  "dpszipplus": "1ah",
                  "formattedaddress": "countess of chester hospital,countess of chester health park,liverpool road,chester,cheshire,ch2 1ul",
                  "additionalitems": {"item": [                  {
                     "key": "datasource",
                     "value": "utilities_register"
                  }]},
                  "groupedadditionalitems": [],
                  "rmudprn": "04584600",
                  "utilitiesinformation":                   {
                     "fueltype": "both",
                     "gasinformation":                      {
                        "lguf": "1",
                        "originalpostcode": "ch2 1ul",
                        "meterpointcount": 4,
                        "meterpoint":                         [
                                                      {
                              "mprn": "0078005206",
                              "metercount": 1,
                              "meter": [{"serialnumber": "m040k0030412d6"}]
                           },
                                                      {
                              "mprn": "8904179407",
                              "metercount": 1,
                              "meter": [{"serialnumber": "m0650d459105b7"}]
                           },
                                                      {
                              "mprn": "9114012204",
                              "metercount": 1,
                              "meter": [{"serialnumber": "m065k0662612d6"}]
                           },
                                                      {
                              "mprn": "0077997606",
                              "metercount": 1,
                              "meter": [{"serialnumber": "g4k00064461101"}]
                           }
                        ]
                     },
                     "electricityinformation":                      {
                        "originalpostcode": "ch2 1ul",
                        "meterpointcount": 1,
                        "meterpoint": [                        {
                           "mpan": "1300035359121",
                           "gspid": "_d",
                           "distributorid": "13",
                           "profiletype": "00",
                           "timeswitchcode": "845",
                           "linelossfactorid": "515",
                           "energisationstatus": "e",
                           "energisationeffectivefromdate":                            {
                              "day": 14,
                              "month": 4,
                              "year": 2016
                           },
                           "metercount": 4,
                           "meter":                            [
                                                            {
                                 "serialnumber": "n507j20880",
                                 "type": "h"
                              },
                                                            {
                                 "serialnumber": "n507j20878",
                                 "type": "h"
                              },
                                                            {
                                 "serialnumber": "n507j20877",
                                 "type": "h"
                              },
                                                            {
                                 "serialnumber": "n507j20879",
                                 "type": "h"
                              }
                           ]
                        }]
                     }
                  }
               },
               {
                  "street": "liverpool road",
                  "town": "chester",
                  "postcode": "ch2 1ul",
                  "buildingname": "eastway house",
                  "stateregion": "cheshire",
                  "countrycode": "gbr",
                  "dpszipplus": "9z8",
                  "formattedaddress": "eastway house,liverpool road,,chester,cheshire,ch2 1ul",
                  "additionalitems": {"item": [                  {
                     "key": "datasource",
                     "value": "utilities_register"
                  }]},
                  "groupedadditionalitems": [],
                  "utilitiesinformation":                   {
                     "fueltype": "electricity",
                     "electricityinformation":                      {
                        "originalpostcode": "ch2 1ul",
                        "meterpointcount": 1,
                        "meterpoint": [                        {
                           "mpan": "1300010375090",
                           "gspid": "_d",
                           "distributorid": "13",
                           "profiletype": "03",
                           "timeswitchcode": "801",
                           "linelossfactorid": "201",
                           "standardsettlementconfiguration": "0393",
                           "energisationstatus": "e",
                           "energisationeffectivefromdate":                            {
                              "day": 1,
                              "month": 4,
                              "year": 2012
                           },
                           "metercount": 1,
                           "meter": [                           {
                              "serialnumber": "e12z110765",
                              "type": "rcamy"
                           }]
                        }]
                     }
                  }
               },
               {
                  "organisation": "hospital energy centre countess of chester hospital",
                  "street": "liverpool road",
                  "town": "chester",
                  "postcode": "ch2 1ul",
                  "buildingname": "countess of chester health park",
                  "stateregion": "cheshire",
                  "countrycode": "gbr",
                  "dpszipplus": "9z8",
                  "formattedaddress": "hospital energy centre countess of chester hospital,countess of chester health park,liverpool road,chester,cheshire,ch2 1ul",
                  "additionalitems": {"item": [                  {
                     "key": "datasource",
                     "value": "utilities_register"
                  }]},
                  "groupedadditionalitems": [],
                  "utilitiesinformation":                   {
                     "fueltype": "gas",
                     "gasinformation":                      {
                        "lguf": "1",
                        "originalpostcode": "ch2 1ul",
                        "meterpointcount": 1,
                        "meterpoint": [                        {
                           "mprn": "9219904005",
                           "metercount": 1,
                           "meter": [{"serialnumber": "m1075d720809b7"}]
                        }]
                     }
                  }
               },
               {
                  "street": "liverpool road",
                  "town": "chester",
                  "postcode": "ch2 1ul",
                  "buildingname": "path lab",
                  "stateregion": "cheshire",
                  "countrycode": "gbr",
                  "dpszipplus": "9z8",
                  "formattedaddress": "path lab,liverpool road,,chester,cheshire,ch2 1ul",
                  "additionalitems": {"item": [                  {
                     "key": "datasource",
                     "value": "utilities_register"
                  }]},
                  "groupedadditionalitems": [],
                  "utilitiesinformation":                   {
                     "fueltype": "gas",
                     "gasinformation":                      {
                        "lguf": "1",
                        "originalpostcode": "ch2 1ul",
                        "meterpointcount": 1,
                        "meterpoint": [                        {
                           "mprn": "9106587507",
                           "metercount": 1,
                           "meter": [{"serialnumber": "m016a1694401a6"}]
                        }]
                     }
                  }
               },
               {
                  "street": "liverpool road",
                  "town": "chester",
                  "postcode": "ch2 1ul",
                  "buildingname": "st johns ambulance building",
                  "stateregion": "cheshire",
                  "countrycode": "gbr",
                  "dpszipplus": "9z8",
                  "formattedaddress": "st johns ambulance building,liverpool road,,chester,cheshire,ch2 1ul",
                  "additionalitems": {"item": [                  {
                     "key": "datasource",
                     "value": "utilities_register"
                  }]},
                  "groupedadditionalitems": [],
                  "utilitiesinformation":                   {
                     "fueltype": "gas",
                     "gasinformation":                      {
                        "lguf": "1",
                        "originalpostcode": "ch2 1ul",
                        "meterpointcount": 1,
                        "meterpoint": [                        {
                           "mprn": "8833875108",
                           "metercount": 1,
                           "meter": [{"serialnumber": "m016a0465612a6"}]
                        }]
                     }
                  }
               },
               {
                  "organisation": "west cheshire nhs trust countess of chester hospital",
                  "street": "liverpool road",
                  "town": "chester",
                  "postcode": "ch2 1ul",
                  "buildingname": "countess of chester health park",
                  "stateregion": "cheshire",
                  "countrycode": "gbr",
                  "dpszipplus": "9z8",
                  "formattedaddress": "west cheshire nhs trust countess of chester hospital,countess of chester health park,liverpool road,chester,cheshire,ch2 1ul",
                  "additionalitems": {"item": [                  {
                     "key": "datasource",
                     "value": "utilities_register"
                  }]},
                  "groupedadditionalitems": [],
                  "utilitiesinformation":                   {
                     "fueltype": "gas",
                     "gasinformation":                      {
                        "lguf": "1",
                        "originalpostcode": "ch2 1ul",
                        "meterpointcount": 1,
                        "meterpoint": [                        {
                           "mprn": "0077983000",
                           "metercount": 1,
                           "meter": [{"serialnumber": "m0650d497913b7"}]
                        }]
                     }
                  }
               }
            ],
            "groupedrelateddata": []
         }]
      }
   }]
}

Error Information

Information on possible error codes is given here: Error Code Information

Get started for free today

  • No credit card required
  • Cancel any time
  • 24/5 support
Get started