{"info":{"_postman_id":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","name":"New POWWR Utility Meter Lookup Service","description":"<html><head></head><body><hr>\n<p>Multi-step Electricity and Gas meter lookup service, to be used at the start of a meter quote journey.</p>\n<p><strong>Typical Usage</strong></p>\n<ol>\n<li>Obtain an OAuth token from the POWWR Auth Server</li>\n<li>Call <code>/addressSearch</code> with the site PostCode to retrieve the meter points for the address.</li>\n<li>Call <code>/meterSearch</code> with the desired MeterAddressId or MPAN/MPRN to fetch the meter properties</li>\n</ol>\n<p>If MPAN/MPRN is known in advance, step 2 can be skipped.</p>\n<hr>\n<p>Version History</p>\n<p>1.0.0</p>\n<ul>\n<li>Initial Schema</li>\n</ul>\n<p>1.0.1</p>\n<ul>\n<li>Added Version history, description, and property examples &amp; descriptions</li>\n<li>Added error response formats RFC7807</li>\n<li>Remove Building and Sub Building on address request</li>\n</ul>\n<p>1.1.0</p>\n<ul>\n<li>Added MeterMechanismCode to GasMeter</li>\n</ul>\n<p>2.0.0</p>\n<ul>\n<li>Removed IsSmart and CurrentSupplierPowwrId</li>\n</ul>\n<p>2.1.0</p>\n<ul>\n<li>Added OrganisationPowwrId, ApplicationId, and UserId</li>\n<li>Added information on MPAN redaction for AddressSearch</li>\n</ul>\n<p>2.2.0</p>\n<ul>\n<li>Added ElectricMeter.GreenDealStatus</li>\n<li>Added GasMeter.Ldz</li>\n<li>Added MeterPointLocation.DeliveryPointAlias</li>\n<li>Added MeterPointLocation.AdministrativeArea</li>\n</ul>\n<p>2.3.0</p>\n<ul>\n<li>Added ElectricMeter.TradingStatus</li>\n<li>Corrected casing on example responses</li>\n<li>Fixed camelCase of property names to match API</li>\n<li>Changed /addressSearch and /meterSearch response from array to object</li>\n<li>Removed incorrect quotes on example responses</li>\n</ul>\n<p>2.4.0 </p>\n<ul>\n<li>Added Supplier object, with fields Mpid, ShortCode, Name, EffectiveDate, and PowwrId</li>\n<li>Added MeterCapacity, DailyMeteredQuantity, CurrentSupplier, IncomingSupplier, and AdditionalInformation to GasMeter</li>\n<li>Added EnergisationStatusEffectiveDate, CurrentSupplier, SMETSVersion, and AdditionalInformation to ElectricMeter</li>\n<li>Removed parameters for IncludeConsumption and IncludeCurrentSupplier - these are no longer required as Consumption and Current Supplier are now always returned</li>\n</ul>\n<p>2.5.0 </p>\n<ul>\n<li>Added meterModel to GasMeter</li>\n</ul>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"53415706","collectionId":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","publishedId":"2sBYAyroFE","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-09-10T14:04:38.000Z"},"item":[{"name":"Search","item":[{"name":"addressSearch","item":[{"name":"/Search/addressSearch","id":"f2abed63-6447-4373-b367-9b2ee02bc69b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"callerIdentification\": {\n    \"organisationPowwrId\": \"UC02-612-S\",\n    \"applicationId\": \"mySystemName\",\n    \"userId\": \"user@myorg.com\"\n  },\n  \"postCode\": \"M22 4DB\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"/Search/addressSearch","auth":{"type":"oauth2","oauth2":{"basicConfig":[],"advancedConfig":[{"key":"scope","value":"<scope>"},{"key":"accessTokenUrl","value":"<access-token-url>"},{"key":"grant_type","value":"<grant_type>"}]},"isInherited":true,"source":{"_postman_id":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","id":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","name":"New POWWR Utility Meter Lookup Service","type":"collection"}},"urlObject":{"path":["Search","addressSearch"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"c1d334e0-b426-4744-89ec-aa21961a1dd0","name":"search results matching criteria","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":"<token>"}],"body":{"mode":"raw","raw":"{\n  \"callerIdentification\": {\n    \"organisationPowwrId\": \"UC02-612-S\",\n    \"applicationId\": \"mySystemName\",\n    \"userId\": \"user@myorg.com\"\n  },\n  \"postCode\": \"M22 4DB\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"/Search/addressSearch"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"meterAddresses\": [\n    {\n      \"meterAddressId\": \"U10023061032A0085759074G1M1610028163246N2PM224DB\",\n      \"fullAddress\": \"PARKWAY HOUSE, PALATINE ROAD, MANCHESTER, M22 4DB\",\n      \"mpanCount\": 2,\n      \"mpans\": [\n        \"**********273\",\n        \"**********231\"\n      ],\n      \"mprnCount\": 1,\n      \"mprns\": [\n        \"*****001\",\n        \"*****001\"\n      ]\n    },\n    {\n      \"meterAddressId\": \"U10023061032A0085759074G1M1610028163246N2PM224DB\",\n      \"fullAddress\": \"PARKWAY HOUSE, PALATINE ROAD, MANCHESTER, M22 4DB\",\n      \"mpanCount\": 2,\n      \"mpans\": [\n        \"**********273\",\n        \"**********231\"\n      ],\n      \"mprnCount\": 1,\n      \"mprns\": [\n        \"*****001\",\n        \"*****001\"\n      ]\n    }\n  ]\n}"},{"id":"d0fdd721-abb6-412e-9ca7-b3b68c4bacfc","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":"<token>"}],"body":{"mode":"raw","raw":"{\n  \"callerIdentification\": {\n    \"organisationPowwrId\": \"UC02-612-S\",\n    \"applicationId\": \"mySystemName\",\n    \"userId\": \"user@myorg.com\"\n  },\n  \"postCode\": \"M22 4DB\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"/Search/addressSearch"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"type\": \"https://httpstatuses.com/400\",\n  \"title\": \"Bad Request\",\n  \"status\": 400,\n  \"detail\": \"Error validating request against JSON Schema for type AddressSearchRequest.\",\n  \"extensions\": {\n    \"errors\": [\n      {\n        \"description\": \"Schema Error: (2, 18) StringExpected\",\n        \"entity\": \"AddressSearchRequest\",\n        \"type\": \"ValueIsInvalid\",\n        \"properties\": [\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          },\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          }\n        ]\n      },\n      {\n        \"description\": \"Schema Error: (2, 18) StringExpected\",\n        \"entity\": \"AddressSearchRequest\",\n        \"type\": \"ValueIsInvalid\",\n        \"properties\": [\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          },\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          }\n        ]\n      }\n    ],\n    \"warnings\": [\n      {\n        \"description\": \"Schema Error: (2, 18) StringExpected\",\n        \"entity\": \"AddressSearchRequest\",\n        \"type\": \"ValueIsInvalid\",\n        \"properties\": [\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          },\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          }\n        ]\n      },\n      {\n        \"description\": \"Schema Error: (2, 18) StringExpected\",\n        \"entity\": \"AddressSearchRequest\",\n        \"type\": \"ValueIsInvalid\",\n        \"properties\": [\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          },\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          }\n        ]\n      }\n    ]\n  }\n}"}],"_postman_id":"f2abed63-6447-4373-b367-9b2ee02bc69b"}],"id":"438b5be9-5cb4-4c02-af4a-d376992981fd","_postman_id":"438b5be9-5cb4-4c02-af4a-d376992981fd","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[],"advancedConfig":[{"key":"scope","value":"<scope>"},{"key":"accessTokenUrl","value":"<access-token-url>"},{"key":"grant_type","value":"<grant_type>"}]},"isInherited":true,"source":{"_postman_id":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","id":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","name":"New POWWR Utility Meter Lookup Service","type":"collection"}}},{"name":"meterSearch","item":[{"name":"/Search/meterSearch","id":"fac704b4-7452-45c2-aa44-e6d0282762d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"callerIdentification\": {\n    \"organisationPowwrId\": \"EXAMPLE-001-B\"\n  },\n  \"meterAddressId\": \"U10023061032A0085759074G1M1610028163246N2PM224DB\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"/Search/meterSearch","auth":{"type":"oauth2","oauth2":{"basicConfig":[],"advancedConfig":[{"key":"scope","value":"<scope>"},{"key":"accessTokenUrl","value":"<access-token-url>"},{"key":"grant_type","value":"<grant_type>"}]},"isInherited":true,"source":{"_postman_id":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","id":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","name":"New POWWR Utility Meter Lookup Service","type":"collection"}},"urlObject":{"path":["Search","meterSearch"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"a78f1c11-87fb-421e-bd40-1b8b14c4f219","name":"search results matching criteria","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":"<token>"}],"body":{"mode":"raw","raw":"{\n  \"callerIdentification\": {\n    \"organisationPowwrId\": \"EXAMPLE-001-B\"\n  },\n  \"meterAddressId\": \"U10023061032A0085759074G1M1610028163246N2PM224DB\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"/Search/meterSearch"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"electricMeters\": [\n    {\n      \"mpan\": \"1610028163273\",\n      \"gspId\": \"_G\",\n      \"energisationStatus\": \"E\",\n      \"energisationStatusEffectiveDate\": \"2024-02-14\",\n      \"profileClass\": \"03\",\n      \"meterTimeswitchClass\": \"801\",\n      \"lineLossFactor\": \"631\",\n      \"standardSettlementConfiguration\": \"0393\",\n      \"measurementClass\": \"A\",\n      \"isDomesticConsumer\": false,\n      \"serialNumber\": \"D07W551948\",\n      \"meterType\": \"N\",\n      \"currentSupplierName\": \"\",\n      \"currentSupplier\": {\n        \"mpid\": \"ENRD\",\n        \"name\": \"British Gas Business\",\n        \"effectiveDate\": \"2024-02-14\",\n        \"powwrId\": \"BRITISHG-001-S\"\n      },\n      \"annualConsumption\": 12345,\n      \"meterPointLocation\": {\n        \"fullAddress\": \"1ST FLOOR EAST WING, PARKWAY HOUSE, PALATINE ROAD, MANCHESTER, LANCASHIRE, M22 4DB\",\n        \"AddressLine1\": \"\",\n        \"AddressLine2\": \"1ST FLOOR EAST WING\",\n        \"AddressLine3\": \"PARKWAY HOUSE\",\n        \"AddressLine4\": \"\",\n        \"AddressLine5\": \"PALATINE ROAD\",\n        \"AddressLine6\": \"\",\n        \"AddressLine7\": \"\",\n        \"AddressLine8\": \"MANCHESTER\",\n        \"AddressLine9\": \"LANCASHIRE\",\n        \"Postcode\": \"M22 4DB\"\n      },\n      \"greenDealStatus\": \"Active\",\n      \"tradingStatus\": \"T\",\n      \"smetsVersion\": \"SMETS1\",\n      \"additionalInformation\": {\n        \"dataAggregatorMpid\": \"ACCU\",\n        \"dataCollectorMpid\": \"ACCU\",\n        \"meterOperatorMpid\": \"OESL\"\n      }\n    },\n    {\n      \"mpan\": \"1620000546231\",\n      \"gspId\": \"_G\",\n      \"energisationStatus\": \"E\",\n      \"energisationStatusEffectiveDate\": \"2024-02-14\",\n      \"profileClass\": \"04\",\n      \"meterTimeswitchClass\": \"874\",\n      \"lineLossFactor\": \"661\",\n      \"standardSettlementConfiguration\": \"0151\",\n      \"measurementClass\": \"A\",\n      \"isDomesticConsumer\": false,\n      \"serialNumber\": \"212397267\",\n      \"meterType\": \"RCAMY\",\n      \"currentSupplierName\": \"\",\n      \"currentSupplier\": {\n        \"mpid\": \"ENRD\",\n        \"name\": \"British Gas Business\",\n        \"effectiveDate\": \"2024-02-14\",\n        \"powwrId\": \"BRITISHG-001-S\"\n      },\n      \"annualConsumption\": 12345,\n      \"meterPointLocation\": {\n        \"fullAddress\": \"1ST FLOOR EAST WING, PARKWAY HOUSE, PALATINE ROAD, MANCHESTER, LANCASHIRE, M22 4DB\",\n        \"AddressLine1\": \"\",\n        \"AddressLine2\": \"1ST FLOOR EAST WING\",\n        \"AddressLine3\": \"PARKWAY HOUSE\",\n        \"AddressLine4\": \"\",\n        \"AddressLine5\": \"PALATINE ROAD\",\n        \"AddressLine6\": \"\",\n        \"AddressLine7\": \"\",\n        \"AddressLine8\": \"MANCHESTER\",\n        \"AddressLine9\": \"LANCASHIRE\",\n        \"Postcode\": \"M22 4DB\"\n      },\n      \"greenDealStatus\": \"Active\",\n      \"tradingStatus\": \"T\",\n      \"smetsVersion\": \"SMETS2\",\n      \"additionalInformation\": {\n        \"dataAggregatorMpid\": \"ACCU\",\n        \"dataCollectorMpid\": \"ACCU\",\n        \"meterOperatorMpid\": \"OESL\"\n      }\n    }\n  ],\n  \"gasMeters\": [\n    {\n      \"mprn\": \"14097001\",\n      \"isIGT\": false,\n      \"exitZone\": \"NW2\",\n      \"ldz\": \"NW\",\n      \"serialNumber\": \"M040K0283013D6\",\n      \"meterType\": \"Synthetic\",\n      \"meterCapacity\": 6,\n      \"meterMechanismCode\": \"CR\",\n      \"dailyMeteredQuantity\": 100,\n      \"currentSupplierName\": \"Scottish Power Energy Retail Limited\",\n      \"currentSupplier\": {\n        \"shortCode\": \"SCT\",\n        \"name\": \"Scottish Power\",\n        \"effectiveDate\": \"2022-03-20\",\n        \"powwrId\": \"SCOTTISH-001-S\"\n      },\n      \"incomingSupplier\": {\n        \"shortCode\": \"EOD\",\n        \"name\": \"E.On Next\",\n        \"powwrId\": \"EONNEXT-001-S\",\n        \"effectiveDate\": \"2024-03-18\"\n      },\n      \"annualConsumption\": 54321,\n      \"meterPointLocation\": {\n        \"subBuilding\": \"\",\n        \"buildingName\": \"PARKWAY HOUSE\",\n        \"buildingNumber\": \"\",\n        \"dependentThoroughfare\": \"\",\n        \"thoroughfare\": \"PALATINE ROAD\",\n        \"dependentLocality\": \"\",\n        \"locality\": \"MANCHESTER\",\n        \"postCode\": \"M22 4DB\",\n        \"fullAddress\": \"PARKWAY HOUSE, PALATINE ROAD, MANCHESTER, M22 4DB,\"\n      },\n      \"additionalInformation\": {\n        \"amrIndicator\": \"N\",\n        \"meterDeviceStatus\": \"LI\",\n        \"meterNumberOfDials\": \"05\",\n        \"previousSupplierName\": \"Octopus Energy Limited\"\n      }\n    }\n  ]\n}"},{"id":"2b0ef933-6146-42eb-91e0-d688282bcda7","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":"<token>"}],"body":{"mode":"raw","raw":"{\n  \"callerIdentification\": {\n    \"organisationPowwrId\": \"EXAMPLE-001-B\"\n  },\n  \"meterAddressId\": \"U10023061032A0085759074G1M1610028163246N2PM224DB\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"/Search/meterSearch"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"type\": \"https://httpstatuses.com/400\",\n  \"title\": \"Bad Request\",\n  \"status\": 400,\n  \"detail\": \"Error validating request against JSON Schema for type AddressSearchRequest.\",\n  \"extensions\": {\n    \"errors\": [\n      {\n        \"description\": \"Schema Error: (2, 18) StringExpected\",\n        \"entity\": \"AddressSearchRequest\",\n        \"type\": \"ValueIsInvalid\",\n        \"properties\": [\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          },\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          }\n        ]\n      },\n      {\n        \"description\": \"Schema Error: (2, 18) StringExpected\",\n        \"entity\": \"AddressSearchRequest\",\n        \"type\": \"ValueIsInvalid\",\n        \"properties\": [\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          },\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          }\n        ]\n      }\n    ],\n    \"warnings\": [\n      {\n        \"description\": \"Schema Error: (2, 18) StringExpected\",\n        \"entity\": \"AddressSearchRequest\",\n        \"type\": \"ValueIsInvalid\",\n        \"properties\": [\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          },\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          }\n        ]\n      },\n      {\n        \"description\": \"Schema Error: (2, 18) StringExpected\",\n        \"entity\": \"AddressSearchRequest\",\n        \"type\": \"ValueIsInvalid\",\n        \"properties\": [\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          },\n          {\n            \"path\": \"$.postCode\",\n            \"providedValue\": {}\n          }\n        ]\n      }\n    ]\n  }\n}"}],"_postman_id":"fac704b4-7452-45c2-aa44-e6d0282762d7"}],"id":"3eeeb1af-ad02-40fd-bb6c-71912c9819c3","_postman_id":"3eeeb1af-ad02-40fd-bb6c-71912c9819c3","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[],"advancedConfig":[{"key":"scope","value":"<scope>"},{"key":"accessTokenUrl","value":"<access-token-url>"},{"key":"grant_type","value":"<grant_type>"}]},"isInherited":true,"source":{"_postman_id":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","id":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","name":"New POWWR Utility Meter Lookup Service","type":"collection"}}}],"id":"e47bf3b5-c31a-43e6-b0a6-6495ffe29ea4","_postman_id":"e47bf3b5-c31a-43e6-b0a6-6495ffe29ea4","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[],"advancedConfig":[{"key":"scope","value":"<scope>"},{"key":"accessTokenUrl","value":"<access-token-url>"},{"key":"grant_type","value":"<grant_type>"}]},"isInherited":true,"source":{"_postman_id":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","id":"c724e3bd-9707-4d1c-a3cd-3d745cb77258","name":"New POWWR Utility Meter Lookup Service","type":"collection"}}}],"auth":{"type":"oauth2","oauth2":{"basicConfig":[],"advancedConfig":[{"key":"scope","value":"<scope>"},{"key":"accessTokenUrl","value":"<access-token-url>"},{"key":"grant_type","value":"<grant_type>"}]}},"variable":[{"key":"baseUrl","value":""}]}