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.