REST API · bulk export · webhooks

Planning and construction intelligence, by API, in your stack.

No other Irish construction-leads source gives you the data programmatically. Planning applications, commencement notices, strategic-infrastructure and energy projects, company firmographics and market intelligence behind one REST endpoint - 220,726 records across all 31 authorities, updated weekly. Query it, bulk-export it, or have matching leads pushed to you every hour.

Data Processing Addendum · SLA · Status · Security

REST over HTTPS · Bearer auth · cursor-paginated exports · OpenAPI spec.

Access levels

Three levels, one API

Access is set by the scope on your key, not by the plan on your account. Every level speaks the same endpoints and the same response shapes, so moving up is a new key, not a new integration.

Commonwealth

commonwealth
Free, any account

Building something on the public record, or trying the API before you commit.

Rate
600 requests / hour
Bulk & keyed reads
1,000 rows a day
  • The public, PII-free planning record across all 31 authorities
  • Same shapes and OpenAPI spec as every level above
  • Attribution required; no redistribution

Enterprise API

ent_api
Included with Max

A commercial team pulling leads into a CRM, a warehouse or an internal tool.

Rate
5,000 requests / hour
Bulk & keyed reads
5,000 rows a day
  • The enriched dataset: the applicant company, firmographics, Company 360 profiles
  • Bulk export as CSV or JSONL, and signed webhooks pushing new matches hourly
  • Licensed for your own organisation's use

Enterprise Feed

ent_feed · custom
Under a data licence

A utility, authority or consultancy putting the dataset on a map, or redistributing it.

Rate
20,000 / hour
Bulk & keyed reads
Uncapped
  • Three GeoJSON layers for QGIS and ArcGIS Pro: planning, infrastructure and area intelligence
  • No daily row budget, on export or on keyed paging
  • Redistribution rights, a published SLA and DPA, and a fixed term with named seats
  • A Custom plan lifts the rate to 120,000 an hour for a bespoke integration

A Max subscription does not reach the feed scopes on its own: those come with an agreement, because they carry redistribution rights and a service level. Once one is signed we record the licence against your organisation and you create the key yourself, in your own browser. We never see it and cannot re-send it. See the Enterprise page for what the agreement covers, or pricing for the plans below it. Network operators and public bodies can see the feeds at work on the utilities and public sector pages.

Two construction professionals reviewing plans on a tablet on site

Irish construction data you can wire straight into your stack, your CRM, your tools.

What you can pull

The dataset on tap - what no one else offers

Leads - search & filter

GET /v1/leads with over 30 filters: text, vertical, authority, readiness, min_value, min_units, has_contact, plus the building (ahb, protected_structure, prefab, construction, heating, roof_work), heritage (in_arch_zone, near_niah) and area (lea, ed) filters. Paged, with a keyset cursor on the export endpoints for whole-set pulls.

GIS feed - GeoJSON

GET /v1/feeds/leads.geojson: the pipeline as a layer for QGIS or ArcGIS Pro, filtered by bounding box, authority, date and the same building, heritage and area filters as the leads list, cursor-paged over the whole layer with a stable integer feature id, so a refresh tells an update from an insert, and an ETag so an unchanged refresh comes back as a 304 with no body. Feed licence.

Bulk export

Stream a filtered slice as JSONL for ETL & pandas, or pull it as a one-shot CSV. Cursor-paginated, with a daily row budget on standard keys and no cap on a Feed licence. Max. Pro can download its filtered list as CSV from the app, with the applicant and company columns blank.

Lead detail - company 360

GET /v1/leads/{id}: project, zoning & appeals, site constraints (archaeology zone, nearby NIAH buildings), area comparables and local prices by Eircode routing area, the Census 2022 profile of the lead's area (Pro and Max seats), suppliers, the appointed main contractor, plus the registered company and its CRO filing history.

Market intelligence

GET /v1/intel/analytics: yield estimates, a repeat-sale price index, emerging zones and material-cost trends - all PII-free.

Webhooks

Push delivery of leads matching your saved filters, HMAC-signed, no polling. Three events: lead.new, lead.on_site and lead.updated, delivered hourly.

Area layers

GET /v1/map/areas/{lea|ed}.geojson for every Local Electoral Area or Electoral Division as a polygon, GET /v1/map/area-stats for leads, on-site work, pipeline value and the Census 2022 shares per area against the national figure, GET /v1/map/area/{code} for one area's profile, and GET /v1/map/eia for major projects. Pro and Max seats in the app; over an API key, area stats and the area panel come with the Max key (ent_api) or an Enterprise licence, and the shapes are open to every key. An Enterprise feed licence adds GET /v1/feeds/areas/{lea|ed}.geojson, every area with its leads, pipeline value, Census 2022 profile and deprivation score in one layer.

Procurement intelligence

GET /v1/views/tenders for public tenders and awards, with bids received on award notices, GET /v1/intel/buyer-competition for one public buyer's past awards (median bids, single-bid share, scoring method, award value range, repeat winners), GET /v1/views/package-buyers for the main contractors holding live public works contracts by county and trade, each contract with an estimated build stage, and GET /v1/firms/awards for one firm's public award history. Organisation winners only. Buyer competition, package buyers and firm award history are built on named organisations, so over an API key they need an enterprise data scope (the Max key or an Enterprise licence); a free key gets a 403 saying so.

Infrastructure & energy

GET /v1/infrastructure for the strategic-infrastructure pipeline (data centres, wind, solar, battery, grid), GET /v1/feeds/infrastructure.geojson for the same pipeline as a GIS layer carrying the applicant and, on 55% of projects, the connection voltage, and GET /v1/infrastructure/renewables for every renewable case lodged with An Coimisiun Pleanala since January 2025, with technology, consenting route and the RED III fast lane flagged.

Usage ledger

GET /v1/account/usage returns what each of your keys did - requests, errors and a breakdown by route - so you can attribute spend and spot a runaway job. Revoked keys keep their history. A permanent per-key daily count backs it, so consumption can be evidenced over a whole licence term, not just the recent window the detailed ledger holds.

OpenAPI spec

Every endpoint, parameter and response schema in a public, machine-readable openapi.json: generate clients from it without an account. The interactive Swagger and ReDoc explorers open once you sign in.

Quickstart

Authenticated in one header

Create a free key on any plan, then send it as a Bearer token on any read endpoint. Every response carries X-RateLimit-* headers so you can back off cleanly. The step-by-step guide walks through keys, filters, paging and limits.

bash
# Authenticate any read endpoint with your Bearer key.
curl -H "Authorization: Bearer pl_live_…" \
  "https://planningleads.ie/api/v1/leads?readiness=commencing&vertical=solar&min_units=20"

Bulk-export the dataset

import pandas as pd, requests

# Stream the whole filtered dataset as JSONL straight into a DataFrame.
url = "https://planningleads.ie/api/v1/export/applications.jsonl"
headers = {"Authorization": "Bearer pl_live_…"}
params = {"readiness": "commencing", "min_units": 20}

resp = requests.get(url, headers=headers, params=params, stream=True)
df = pd.read_json(resp.raw, lines=True)

print(df[["planning_authority", "est_value", "lead_readiness"]].head())

Individual (homeowner) names are masked at every tier - there is no bulk export of homeowner PII. The named organisation behind a row is a Max field, so a Pro export carries those two columns blank rather than dropping them.

Add it to your GIS

bash
# Add the live pipeline to QGIS or ArcGIS Pro as a layer.
# QGIS: Layer > Add Layer > Add Vector Layer, Protocol HTTP(S), and this URL,
# with Authentication set to a Bearer token.
curl -H "Authorization: Bearer pl_live_…" \
  "https://planningleads.ie/api/v1/feeds/leads.geojson?page_size=5000&updated_since=2026-09-01"

# Filter the layer the way you would any other: by bounding box, by authority,
# or by date so a scheduled refresh pulls only what changed.
#   ?bbox=-6.30,53.33,-6.25,53.36
#   ?authority=Dublin%20City%20Council
#   ?since=2026-09-01        # first seen
#   ?updated_since=2026-09-01  # changed since

# The strategic pipeline is a second layer: every project An Coimisiun Pleanala
# consents directly, with capacity in MW, connection voltage and auction round.
curl -H "Authorization: Bearer pl_live_…" \
  "https://planningleads.ie/api/v1/feeds/infrastructure.geojson?vertical=battery_storage&min_mw=50"

Every feature is a point with its full record attached and a link back to its public page. Needs a Feed licence key.

Webhooks

Matching leads, pushed to you. No polling.

Register a webhook and we POST leads that match your saved filters when they first appear, when they break ground, or when their record changes. Each request is HMAC-SHA256 signed with an X-PL-Signature header - recompute it over the raw body and compare timing-safe. Set one up under Account, then follow the API guide in the docs for the events and the signature header.

lead.newlead.on_sitelead.updated

Built for

Wire it into the tools you already run

QS & estimating tools

Pull commencing schemes by unit count and estimated value, with material-cost trends to feed pricing models and BoQs.

Proptech & CRMs

Sync filtered leads and company 360 records straight into your pipeline; get new matches pushed over webhooks as they file.

Investors & analysts

Query the repeat-sale index, yield estimates and emerging zones across 790k PPR sales to back development and acquisition calls.

Estate agents

Track planning and commencements in your patch, surface the developer behind each site, and reach out before it lists.

Utilities, grid & energy consultants

Where connection demand is forming: grid-scale battery storage told apart from domestic, substation and line consents, the renewable cases in the RED III fast lane, RESS auction winners flagged on the applications they name, and the CRU connection rule surfaced on data-centre schemes.

PII-safe by design

Organisation-level data only - individual (homeowner) names are masked. Built around Ireland's open-data licence and GDPR.

Rate-limited & paginated

Standard X-RateLimit-* headers (Reset is epoch seconds) and cursor-paginated exports keep large pulls stable and predictable.

Published terms

A Data Processing Addendum, an SLA with a 99.5% availability target and a 90-day deprecation notice, and a live status page - all published, not on request.

Start building.

Get a free commonwealth key on any plan. Max adds the enriched fields, bulk export and webhooks. The GIS feeds and uncapped bulk need a Feed licence, which comes with an Enterprise agreement.