PlanWatch API

{
  "data": { ... },
  "meta": {
    "attribution": "Data © Irish planning authorities, via PlanWatch.ie — see https://planwatch.ie/data-sources.html",
    "docs": "https://planwatch.ie/api.html"
  },
  "error": null
}

curl -H "X-API-Key: pw_live_xxx" \
  "https://planwatch.ie/api/v1/applications?q=extension&authority=Fingal%20County%20Council"

GET/applications

Full-text and/or filtered search — requires at least a query or one filter. Reference numbers (e.g. 24/449, F24A/0123) are detected and matched exactly first.

Param	Description
q	Free-text query or a planning reference number.
authority	Authority name, e.g. Fingal County Council (all or omitted = every authority).
decisions	Comma-separated outcome buckets: granted, refused, further_info, withdrawn, invalid, pending.
application_type	e.g. PERMISSION, RETENTION, OUTLINE PERMISSION. Comma-separated for multiple.
dev_type	Development type, e.g. Residential, Commercial.
after / before	Received on/after / on/before a date (YYYY-MM-DD).
all_time	1 = filter-only search with no date window.
has_fi	true = only applications with a further-information request.
has_appeal	true = only applications with an An Coimisiún Pleanála appeal.
architect	Filter by architect/agent name (fuzzy match).
sort	newest (default), oldest, or decided.
limit	Page size (default 50, max 200).
offset	Page offset (default 0).

GET /api/v1/applications?q=house%20extension&authority=Dublin%20City%20Council&decisions=granted&limit=2

{
  "data": [
    {
      "id": "Dublin City Council_24003",
      "application_number": "24003",
      "authority": "Dublin City Council",
      "address": "3 Elm Rd, Dublin 5",
      "description": "Demolition of shed and construction of dwelling",
      "status": "GRANTED",
      "decision": "Grant Permission",
      "application_type": "PERMISSION",
      "received_date": "2024-05-20",
      "decision_date": "2024-08-20",
      "link": "https://planning.dublin.ie/24003",
      "architect_name": "Smith & Associates Architects"
    }
  ],
  "meta": {
    "attribution": "Data © Irish planning authorities, via PlanWatch.ie — see https://planwatch.ie/data-sources.html",
    "total": 1, "showing": 1, "limit": 2, "offset": 0
  },
  "error": null
}

Every field is always present; unknown values are null. Dates are ISO-8601 (YYYY-MM-DD).

GET/applications/{id}

id is the stable PlanWatch ID from search results, e.g. Fingal County Council_FW24A/0123. Returns the full record: everything in the search summary plus dev_type, planner_name, conditions_count and abp_link. Where a national Building Control notice matched, it also includes commencement_date, completion_date, bcn_status and a building_control object of building facts (notice ref, units, floor area) — no personal data. Unknown ID → 404 not_found.

GET/nearby

Applications near a point, ordered by distance.

Param	Description
lat	Latitude (required).
lng	Longitude (required).
radius	Radius in metres (default 1000, max 10000).
months	Only applications received in the last N months.
limit	Page size (default 20, max 100).

GET /api/v1/nearby?lat=53.3498&lng=-6.2603&radius=2000&limit=20

Each item is a compact application record plus distance_m. meta includes total, center and radius_m.

GET/authorities

All 31 planning authorities. No parameters. Each item: authority, slug, total_applications, earliest_received_date, latest_received_date. Use slug with the stats endpoint.

GET/authorities/{slug}/stats

slug comes from GET /authorities (e.g. fingal, dublin-city). Returns authority, slug, total_applications, pending, avg_decision_days, fi_rate_percent and applications_last_year. Unknown slug → 404.

GET/agents/{id}

id is the agent entity ID (from agent links on planwatch.ie or search results' architect data). Basic profile — name, website, volume, coverage, activity — is available on any tier. Full intelligence (success/FI/appeal rates, processing days, quality score, benchmarks) requires a Pro key; without one those fields are null and intelligence_locked is true.

GET/openapi.json

The full OpenAPI 3.1 document. Unmetered.