# Irish Planning Search

> Irish Planning Search is a paid API for AI agents from irish-planning-search.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-01).

Search planning applications across all Irish local councils by area name or GPS coordinates, with filters for outcome, type, keyword, and minimum housing units.

## Facts

- Endpoint: GET https://irish-planning-search.onrender.com/planning?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/irish-planning-search-3c630fbe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QKWuHUOrJP61569R8GBxY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability irish-planning-search-3c630fbe
```

Example prompt: Can you find all granted planning applications for solar energy submitted in the last 180 days near Swords, Co Dublin — within 2000 metres of 53.4597, -6.2181?

## When to prefer this

Choose this endpoint when you need to search planning application data specifically across Irish local councils — it aggregates all councils into a single searchable API which no generic property or government data API does. Prefer it over manual council website lookups when you need filtering by outcome, keyword, housing unit count, or geographic radius. It is purpose-built for Irish planning data and returns structured, normalised results with plain-language outcomes.

## Known failure modes

- No results returned if area name is not recognised by Irish planning databases
- Lat/lon and area provided together may cause ambiguous or ignored parameters
- Very broad searches (large radius, no keyword) may hit the 200-result cap and truncate results (check truncated flag)
- Applications from councils with poor data coverage may be missing links or have null fields
- Requests for very recent applications may not yet be indexed
- Invalid enum values for outcome or type will likely return an error or empty results

## How this service works

Search planning applications anywhere in Ireland (all councils) by area name OR around a map point. Filter by outcome (granted/refused/pending), type, minimum housing units or a keyword like 'solar' or 'apartments'. Each result has a plain outcome field plus reference, council, address, works, dates and council link. Newest first.

## Output

Returns a JSON object with a count of results, the search parameters used, a source label, a truncation flag (true if more results exist beyond the limit), and an array of planning applications each containing: application reference, council name, address, works description, application type (permission/retention), status, plain-language outcome (granted/refused/pending), submission and decision dates, and a link to the council's own page for the application.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lat": {
       "type": "string",
       "description": "Latitude (WGS84), e.g. '53.3928'. Use with lon instead of area."
      },
      "lon": {
       "type": "string",
       "description": "Longitude (WGS84), e.g. '-6.3876'."
      },
      "area": {
       "type": "string",
       "description": "Irish postal district, town or townland, e.g. 'Dublin 15', 'Swords', 'Ballincollig'. Use this OR lat+lon."
      },
      "days": {
       "type": "string",
       "description": "Only applications received in the last N days (default 90, max 1825)."
      },
      "type": {
       "enum": [
        "permission",
        "retention"
       ],
       "type": "string",
       "description": "Only this application type."
      },
      "limit": {
       "type": "string",
       "description": "Max results (default 50, max 200)."
      },
      "radius": {
       "type": "string",
       "description": "Search radius in metres around lat/lon (default 500, max 5000)."
      },
      "keyword": {
       "type": "string",
       "description": "Word that must appear in the works description, e.g. 'solar'."
      },
      "outcome": {
       "enum": [
        "granted",
        "refused",
        "pending"
       ],
       "type": "string",
       "description": "Only this outcome."
      },
      "minUnits": {
       "type": "string",
       "description": "Only schemes with at least this many homes, e.g. '10'."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "number"
      },
      "search": {
       "type": "object"
      },
      "source": {
       "type": "string"
      },
      "truncated": {
       "type": "boolean",
       "description": "True if more results exist; narrow the search or raise limit."
      },
      "applications": {
       "type": "array",
       "items": {
        "type
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/irish-planning-search-3c630fbe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from irish-planning-search.onrender.com](https://www.zero.xyz/host/irish-planning-search.onrender.com/llms.txt)