Authentication
In order to use the PropEco API, you must ensure that your requests are authenticated.
An API key must be given with every request as the following header:
x-api-key: <API KEY>
Requests authenticated with this method resemble the following structure:
curl \
-X GET \
--header "x-api-key: <API KEY>" \
https://api.propeco.io/...
const results = await fetch(`https://api.propeco.io/...`, {
headers: {
"x-api-key": API_KEY
},
});
const data = await results.json();
Any requests made without an API key will be met with a 403 response (access denied).
Test Keys
Test keys can be used to search the Properties, Location, Flood Risk, EPCs and Retrofit endpoints using either:
-
UPRNs 34076006, 906178651 or 10014197137.
-
The following lat / lng coordinates: 51.47 -0.19 | 55.98 -3.19 | 51.45 -3.19.
Request Quotas
Each of our API products is subject to a monthly request quota depending on the tier of subscription.
Check out our available API tiers here.
Request Throttling
All requests made to PropEco API products are throttled to 1 request per second per subcription.