GET 17.0/app/properties/epc/lookup?postcode={postcode}&usage={usage}

Description

Retrieves a list of EPCs

URI Parameters
Name Description Type Additional information
postcode

The Postcode to search for

 string

None.
usage

The Property Usage of the Property

 PropertyUsage

Default value is Residential

None.

None.

A list of EPCs

Collection of LookupResult
Name Description Type Additional information
Address

string

None.
Reference

string

None.
ExpiryDate

date

None.

application/json, text/json
Sample: 
[
  {
    "address": "sample string 1",
    "reference": "sample string 2",
    "expiryDate": "2025-01-09T20:08"
  },
  {
    "address": "sample string 1",
    "reference": "sample string 2",
    "expiryDate": "2025-01-09T20:08"
  }
]

application/xml, text/xml
Sample: 
<ArrayOfLookupResult xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <LookupResult>
    <Address xmlns="http://tempuri.org/">sample string 1</Address>
    <Reference xmlns="http://tempuri.org/">sample string 2</Reference>
    <ExpiryDate xmlns="http://tempuri.org/">2025-01-09T20:08:49.8761156+00:00</ExpiryDate>
  </LookupResult>
  <LookupResult>
    <Address xmlns="http://tempuri.org/">sample string 1</Address>
    <Reference xmlns="http://tempuri.org/">sample string 2</Reference>
    <ExpiryDate xmlns="http://tempuri.org/">2025-01-09T20:08:49.8761156+00:00</ExpiryDate>
  </LookupResult>
</ArrayOfLookupResult>