PROPDATAESTONIA · API DOCS
ESTONIA · PRODUCTION COUNTRY CONTRACT

Official identity.
Deep property intelligence.

PropData Estonia resolves official ADS addresses, native cadastral codes and coordinates into a governed property graph spanning national land intelligence, assessed land value, explicit object relationships, available parcel geometry and — where populated — EHR building, energy and document history.

1.39M+normalized addresses
778,325land-enriched cadastral units
971K+building ↔ parcel links
2.44M+property objects
10.27M+object ↔ address links

Coverage is a field, not a promise.

Estonia is already a deep country product, but every layer has its own rollout truth. National cadastral land is live. Geometry and EHR-derived layers remain coverage-aware while national reconciliation and backfill continue.

NATIONAL · LIVECadastral land778,325 rows loaded: area, intended use, registration date and assessed land value. Ownership type and registered immovable number are returned where published.
EXPANDING NATIONAL BASELINEParcel geometryWhole-country geometry reconciliation is actively increasing materialized polygon coverage.
COVERAGE-AWAREEHR buildings + historyBuilding specifications, footprints, energy and document history return where the EHR layer is populated; national backfill continues.
Fail-closed source facts: unavailable or unverified facts remain unavailable. A 200 response does not mean every optional enrichment layer is present.

Three ways into one Estonia property.

1 · Native cadastral code

/v1/property?country=EE&parcel=78404:406:4330

2 · Official address

/v1/property?country=EE&address=...

3 · Coordinates

/v1/property/by-location?country=EE&lat=...&lng=...

Deep response

enrich=full attaches Estonia-specific source layers where covered.

cURL · 78404:406:4330
curl "https://propdata-api-worker.sales-fd3.workers.dev/v1/property?country=EE&parcel=78404:406:4330&enrich=full" \
  -H "x-api-key: $PROPDATA_API_KEY"

Credentials stay server-side.

Direct REST uses the x-api-key header. Production keys belong in server-side secrets or environment variables — never URLs, browser bundles, screenshots, analytics or repositories. PropData MCP uses OAuth and is a different authorization flow.

Customer-safe REST surface.

These are the public routes used by the Estonia experience. Internal database RPCs, ingest tables and service-role operations are intentionally excluded.

GET/v1/property

Address or cadastral resolver. Add enrich=full for deeper Estonia-specific enrichment where covered.

GET/v1/property/by-location

WGS84 coordinate → containing parcel/property context.

GET/v1/countries

Country-aware platform capability context.

GET/v1/auth/usage

Authoritative account usage and limits.

GET/v1/health

Public production service health.

GET/v1/changelog

Production API and data-platform changes.

Address → property

Resolve an official ADS address and attach the property graph beneath it where available. Address responses can expose ADR_ID, ADS code-address, lifecycle/source timestamps, hierarchy, source coordinates, related property objects and parcel attachment.

GET/v1/property?country=EE&address=...
GET /v1/property?country=EE&address=Viljandi%20maakond%2C%20Mulgi%20vald%2C%20Abja-Paluoja%20linn%2C%20P%C3%A4rnu%20mnt%2051a

Cadastral code → deep property

Use the native Estonian katastritunnus directly. Canonical PropData parcel IDs are also accepted where supported by the resolver.

GET/v1/property?country=EE&parcel=78404:406:4330&enrich=full
Documented deep-response proof: this cadastral code has returned a 600 m² residential parcel, private ownership type, €123,108 assessed land value, registered immovable number, polygon geometry, a linked EHR building, energy history and a 14-event document timeline.
Selected response shape
{
  "country_code": "EE",
  "match_level": "cadastral_code",
  "coverage_status": "live_enriched",
  "parcel": {
    "global_parcel_id": "EE:MAARUUM:CADASTRE:ads_ky.10761487",
    "geometry": {"type":"Polygon"}
  },
  "estonia": {
    "land": {
      "cadastral_code": "78404:406:4330",
      "area_sqm": 600,
      "intended_uses": [{"use":"ELAMUMAA","percent":100}],
      "ownership_type": "Eraomand",
      "assessed_land_value_eur": 123108,
      "registered_immovable_number": "3298301"
    },
    "ehr_buildings": [{
      "ehr_code": "101000361",
      "first_usage_year": 1956,
      "dimensions": {"floors_count":2,"closed_net_area_sqm":113},
      "energy_certificate_history": {"count":1},
      "documents": {"count":14}
    }]
  }
}

Coordinates → property

Resolve WGS84 coordinates to containing Estonia parcel context without requiring an address-string match.

GET/v1/property/by-location?country=EE&lat=58.12511901&lng=25.34680635

National cadastral land intelligence

The national cadastral enrichment baseline contains 778,325 units. The Estonia response can attach area, intended uses and percentages, land-area composition, ownership type where published, registered immovable number, registration/change dates and official assessed land value in EUR.

Valuation semantics: assessed_land_value_eur is official assessed land value — not an AVM and not a market-sale estimate.

ADS is a relationship graph, not just an address list.

The Estonia graph carries 2.44M+ property objects, 10.27M+ object↔address relationships and 971K+ building↔parcel relationships. PropData preserves those explicit links instead of collapsing them into a single guessed property record.

Address identity

ADR_ID, code-address, hierarchy, coordinates and lifecycle context.

Property objects

Source-native object identity remains visible in the normalized graph.

Parcel attachment

Address and object relationships attach to cadastral identity where resolved.

Geometry is coverage-aware.

Estonia parcel geometry is being reconciled nationally. When materialized, PropData returns source-aware GeoJSON-ready geometry. A missing polygon must remain unavailable rather than being inferred from a centroid, address point or nearby parcel.

EHR building intelligence

Where populated, EHR building enrichment can attach building identity/status, first-use year, floor count, closed net area, footprint, volume, primary use, construction materials and technical systems. National EHR backfill is coverage-aware and continues independently of the already-live cadastral land baseline.

Energy certificates

Where published and linked through EHR, PropData can attach certificate number, ETA/KEK type and value, energy class, status, issue date and expiry date. Absence of a certificate in the response is not proof that a building has never had one unless the returned coverage supports that conclusion.

Permits & document history

The EHR document layer normalizes available building permits, permit applications, occupancy/use records, construction-start notices, design conditions, registry events and restriction notices into a source-aware timeline.

Country product, global control plane.

/v1/countries

Country-aware capability context across the PropData network.

/v1/auth/usage

Authoritative account usage and limits.

/v1/health

Public service health for operational checks.

/v1/stats · /v1/changelog

Platform proof points and production changes.

Handle failures by category.

StatusMeaningRecommended behavior
400Validation / invalid requestCorrect parameters before retrying.
401Authentication failedCheck server-side credential and account state.
403Entitlement restrictionVerify plan or layer entitlement; do not retry blindly.
429Rate limitUse authoritative usage headers and backoff.
5xxTransient service/upstream failureRetry conservatively; preserve a valid base property result if only optional enrichment failed.

Authoritative sources in. Governed delivery out.

Core Estonia property identity and cadastral layers are built from official Maa- ja Ruumiamet source systems, including ADS/cadastral infrastructure. Building, energy and document intelligence is sourced from Estonia's EHR where available. PropData operates ingestion, normalization, canonical identity, relationship graphs, coverage semantics and production delivery above those systems.

Source truth wins: PropData does not fabricate missing Estonia facts, treat assessed land value as market value, or imply complete EHR/geometry coverage where a layer is still expanding.
EE · COUNTRY WORKSPACE

Test the Estonia contract without leaving the country product.

The EE Workspace is the operating surface for live request testing, country coverage, response inspection, account usage and developer handoff.

Open EE Workspace →