Use this request to search precedent records across Ireland and return a lightweight result set you can page through.
#Request
GET /ext/v1/precedents
#Query Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
q | string | No | Full-text search query across address, description, applicant name, and planning reference. | apartment, residential |
local_authority | string | No | Filter by local authority. | Dublin City Council |
status | string | No | Filter by normalized status. | decided |
decision | string | No | Filter by normalized decision. | granted |
limit | integer | No | Maximum results per page, from 1 to 100. Default is 20. | 50 |
offset | integer | No | Pagination offset. | 0 |
#Example Request
curl "https://api.eireplan.ie/ext/v1/precedents?q=apartment&local_authority=Dublin%20City%20Council&limit=2" \
-H "Authorization: Bearer ek_your_api_key_here"#Response Structure
| Field | Type | Description |
|---|---|---|
precedents | array | Search results for the current page. |
next | string | Cursor for the next page, or null when there is no next page. |
Each item in precedents includes:
| Field | Type | Description |
|---|---|---|
id | string (UUID) | Stable precedent identifier. |
planning_ref | string | Official planning reference. |
address | string | Site address. |
description | string | Application description. |
local_authority | string | Responsible authority. |
decision_norm | string | Normalized decision value. |
status_norm | string | Normalized status value. |
type_norm | string | Normalized application type. |
received_date | string | Date received in ISO 8601 format. |
decision_date | string | Date decided in ISO 8601 format. |
is_favourite | boolean | Whether the precedent is in the watchlist. |
#Example Response
json
{
"precedents": [
{
"id": "5f8fcb68-2be1-4ce7-8ef4-6a29c2fb4aa8",
"planning_ref": "DCC-1234-25",
"address": "15 Example Street, Dublin 2",
"description": "Mixed-use development with 42 apartments",
"local_authority": "Dublin City Council",
"decision_norm": "granted",
"status_norm": "decided",
"type_norm": "permission",
"received_date": "2025-03-12",
"decision_date": "2025-08-07",
"is_favourite": false
}
],
"next": "eyJvZmZzZXQiOjJ9"
}#Next Step
Use the returned id with Get Precedent Details when you need the full record for one result.