1. Create a GetAddress.io Account Go to https://getaddress.io and sign up.

Generate an API Key from your account dashboard.

2. Install or Open Bubble’s API Connector
In your Bubble editor, go to the Plugins tab.

Click Add Plugins and search for API Connector (if not already installed).

Click Add another API and name it: GetAddress UK.

3. Set Shared Headers
Click Add a shared header.

Key: api-key

Value: Paste your API key from GetAddress.io

Set the visibility to Secret.

Step-by-Step Usage (Example API Calls)
1. Nearest Address
Method: GET

URL: https://api.getAddress.io/nearest/[latitude]/[longitude]

Add two URL parameters:

latitude (Public)

longitude (Public)

Use this in a workflow to return the nearest address to the provided location.

2. Get Address Details by ID
Method: GET

URL: https://api.getAddress.io/get/[id]

Parameter:

id – Use the value returned from a prior lookup or autocomplete.

3. Distance by Postcode
Method: GET

URL: https://api.getAddress.io/distance/[postcode_from]/[postcode_to]

Parameters:

postcode_from and postcode_to (Public)

Returns the distance between two UK postcodes.

4. Typeahead Endpoints
All use the same base URL:
https://api.getAddress.io/typeahead/[term]

Method: POST

Body Type: JSON

5. Validate Address
Method: GET

URL: https://api.getAddress.io/validate/[unstructured address]

Use for checking and cleaning up free-text addresses.

4. Use in Workflows or Data Sources
After setting each API call, click Reinitialize call to load the sample response.

Then:

Use the API call in Workflows for real-time lookups.

Or, use it as a Data source for repeating groups, inputs, or map features.