EirePlan
Endpoints/Precedents API

Get Precedent Details

Fetch one precedent record by ID with full detail.

Use this request when you already have a precedent id and need the richer detail record.

#Request

GET /ext/v1/precedents/:id

#Path Parameters

ParameterTypeRequiredDescription
idstringYesPrecedent UUID returned by the search endpoint.

#Example Request

curl "https://api.eireplan.ie/ext/v1/precedents/5f8fcb68-2be1-4ce7-8ef4-6a29c2fb4aa8" \
  -H "Authorization: Bearer ek_your_api_key_here"

#Response Structure

FieldTypeDescription
precedent.idstring (UUID)Unique precedent identifier.
precedent.planning_refstringOfficial planning reference.
precedent.addressstringSite address.
precedent.descriptionstringApplication description.
precedent.applicantstringApplicant or developer name.
precedent.local_authoritystringResponsible authority.
precedent.decision_normstringNormalized decision value.
precedent.received_datestringReceived date.
precedent.decision_datestringFinal decision date.
precedent.official_record_urlstringLink to the official planning record.
precedent.official_docs_urlstringLink to official planning documents.
precedent.has_polygonbooleanWhether site boundary geometry is available.
precedent.pointobjectGeoJSON point for the site location.

#Example Response

json
{
  "precedent": {
    "id": "5f8fcb68-2be1-4ce7-8ef4-6a29c2fb4aa8",
    "planning_ref": "DCC-1234-25",
    "address": "15 Example Street, Dublin 2",
    "description": "Mixed-use development with 42 apartments",
    "applicant": "Example Developments Ltd",
    "local_authority": "Dublin City Council",
    "decision_norm": "granted",
    "received_date": "2025-03-12",
    "decision_date": "2025-08-07",
    "official_record_url": "https://planning.localauthority.ie/records/DCC-1234-25",
    "official_docs_url": "https://planning.localauthority.ie/docs/DCC-1234-25",
    "has_polygon": true,
    "point": {
      "type": "Point",
      "coordinates": [-6.2603, 53.3498]
    }
  }
}

#Where It Fits

Start with Search Precedents if you do not already have the precedent identifier.