1. Install the Plugin In your Bubble editor, go to the Plugins tab

Click "Add plugins" and install this private plugin (or your custom version)

2. Authentication (HTTP Basic Auth)
Set Authentication type to HTTP Basic Auth

Enter your official EPC Register username and password

You can request access and credentials from https://epc.opendatacommunities.org/

⚠️ These credentials are stored in the plugin editor and won’t be visible to app users.

3. API Calls Overview
A. EPC Data Lookup (/domestic/search)
This is the main search call. It supports optional query parameters such as:

address, postcode, local-authority, uprn

constituency, built-form, property-type, construction-age-band

inspection-date, lodgement-datetime, size, from, to-year

✅ Use it in workflows to filter certificates by:

Specific addresses or postcodes

Construction type (e.g., “bungalow”, “flat”, “maisonette”)

Inspection year (e.g., “2023”)

B. Certificate Details by lmk_key (/domestic/certificate/{lmk_key})
This call fetches the full certificate JSON for a specific property using its unique identifier lmk_key.

Use this after selecting a search result and want full details like:

EPC rating

Current energy efficiency

Recommendations

CO2 impact and more

4. Using in Bubble
To use in your app:

Add a Search Form on your page (address or postcode input fields)

Trigger the “EPC Data Lookup” call in a workflow

Display results in a Repeating Group

When a user selects a row, use the lmk_key to trigger the “Certificate Details” call and show full details in a popup or new group