landfeedAPI · MCP · 2.0.0PolskiAgent Markdown

Four coverage states: unknown is never no

A missing result cannot establish that a parcel has no plan, hazard or restriction. Read each layer's coverage, source, as_of and note together.

StateEvidenceConsumer action
coveredThe source covers the place and provides a result.Report it with source, date and actual evidence scope.
covered_no_dataCoverage is established but no matching record/object is present.Say no record was found in the data covering this parcel, limited to that source and scope.
not_coveredCoverage or a reliable evidence basis is absent.Report unknown, with value: null; never render this as false.
not_computedThe result has not been computed.Say so; do not substitute false or an empty list.

For flood maps, covered_no_data means no matching mapped zone at the declared scope, not absence of every possible flood or waterlogging hazard. not_covered cannot support even that limited negative. An empty MPZP integration lookup does not establish a plan's legal status.

Scope, method and date

V2 adds scope, method and licence. Scope is parcel_polygon, point, obreb (cadastral precinct), gmina (municipality) or grid. Point evidence must not become a whole-parcel conclusion. Method distinguishes official, derived, computed and extracted. Extraction is a method, not a fifth coverage state; below-threshold extraction becomes not_covered.

as_of is the source data date, not request time. Null means unknown. meta.generated_at does not refresh the source. A listed layer or approved licence does not prove coverage for a particular parcel.

Polish domain glossary

A działka ewidencyjna is a cadastral parcel; obręb is its cadastral precinct; gmina is municipality. Plan ogólny (POG) is the municipality's general plan; MPZP is miejscowy plan zagospodarowania przestrzennego (local spatial development plan); WZ is warunki zabudowy (development conditions). Preserve these Polish terms in identifiers and explanations.

Plan states draft, adopted, in_force, none distinguish stages. Adoption alone does not mean a plan is in force. MPZP legal status can be null when a zone is identified without a known legal status; never translate null to none. No plan does not settle buildability; road evidence does not settle legal access. RCN means Rejestr Cen Nieruchomości: its aggregate concerns the entire obręb, not a parcel valuation. See sources and answer boundaries.

Parcel features, search and place suggestions

The card's existing 1 credit includes result.features: 20 sourced fields, each with value, unit, source, as_of, method, coverage and note. The RCN feature is a municipality cohort, rounded to 50 PLN/m² and suppressed below six sales. It is context rather than an individual parcel valuation. Road geometry never proves legal access. Missing inputs remain explicit unknowns.

FeatureSchema
shape_and_size.area_official_m2{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "m2"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}
shape_and_size.area_geometry_m2{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "m2"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}
shape_and_size.perimeter_m{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "m"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}
shape_and_size.shape_regularity{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "ratio"}, "value": {"anyOf": [{"maximum": 1, "minimum": 0, "type": "number"}, {"type": "null"}]}}}]}
shape_and_size.squareness{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "ratio"}, "value": {"anyOf": [{"maximum": 1, "minimum": 0, "type": "number"}, {"type": "null"}]}}}]}
shape_and_size.elongation{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "ratio"}, "value": {"anyOf": [{"minimum": 1, "type": "number"}, {"type": "null"}]}}}]}
access_and_roads.public_road_distance_m{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["bdot_roads"]}}}, "unit": {"const": "m"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}
access_and_roads.road_access{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["bdot_roads", "egib_dr_parcels", "egib_parcels"]}}}, "unit": {"const": null}, "value": {"anyOf": [{"type": "boolean"}, {"type": "null"}]}}}]}
access_and_roads.frontage_m{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_dr_parcels", "egib_parcels"]}}}, "unit": {"const": "m"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}
land_use.land_use_classes{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": null}, "value": {"anyOf": [{"items": {"pattern": "^[A-Za-zŁłŻż]{1,5}(?:[IVX]{1,4}[ab]?)?$", "type": "string"}, "maxItems": 100, "type": "array", "uniqueItems": true}, {"type": "null"}]}}}]}
land_use.pog_zone_class{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["pog_sweep", "pog_zones"]}}}, "unit": {"const": null}, "value": {"anyOf": [{"enum": ["SW", "SJ", "SN", "SU", "SH", "SI", "SZ", "SC", "SG", "SO", "SR", "SK", "SP"], "type": "string"}, {"type": "null"}]}}}]}
buildings_and_surroundings.buildings_present{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_buildings"]}}}, "unit": {"const": null}, "value": {"anyOf": [{"type": "boolean"}, {"type": "null"}]}}}]}
buildings_and_surroundings.building_count{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_buildings"]}}}, "unit": {"const": "count"}, "value": {"anyOf": [{"minimum": 0, "type": "integer"}, {"type": "null"}]}}}]}
buildings_and_surroundings.building_footprint_m2{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_buildings"]}}}, "unit": {"const": "m2"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}
buildings_and_surroundings.building_coverage_pct{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_buildings"]}}}, "unit": {"const": "percent"}, "value": {"anyOf": [{"maximum": 100, "minimum": 0, "type": "number"}, {"type": "null"}]}}}]}
buildings_and_surroundings.buildings_500m{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_buildings"]}}}, "unit": {"const": "count"}, "value": {"anyOf": [{"minimum": 0, "type": "integer"}, {"type": "null"}]}}}]}
prices_nearby.rcn_gmina_median_pln_m2{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["rcn_clean_agg"]}}}, "unit": {"const": "PLN/m2"}, "value": {"anyOf": [{"minimum": 0, "multipleOf": 50, "type": "number"}, {"type": "null"}]}}}]}
prices_nearby.rcn_gmina_sales_count{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["rcn_clean_agg"]}}}, "unit": {"const": "count"}, "value": {"anyOf": [{"minimum": 6, "type": "integer"}, {"type": "null"}]}}}]}
development_activity.gunb_activity_gmina{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["gunb_permits"]}}}, "unit": {"const": "count"}, "value": {"anyOf": [{"minimum": 0, "type": "integer"}, {"type": "null"}]}}}]}
development_activity.gunb_activity_500m{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["gunb_permits"]}}}, "unit": {"const": "count_min"}, "value": {"anyOf": [{"minimum": 0, "type": "integer"}, {"type": "null"}]}}}]}
{
  "shape_and_size": {
    "area_official_m2": {
      "value": 1200,
      "unit": "m2",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "egib_declared_calibrated_m2_v1",
      "coverage": "covered",
      "note": "Powierzchnia ewidencyjna z danych EGiB."
    },
    "area_geometry_m2": {
      "value": 1200.0,
      "unit": "m2",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "postgis_area_epsg2180_v1",
      "coverage": "covered",
      "note": "Wynik obliczony z obrysu działki. Nie określa możliwości zabudowy."
    },
    "perimeter_m": {
      "value": 140.0,
      "unit": "m",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "postgis_perimeter_including_holes_epsg2180_v1",
      "coverage": "covered",
      "note": "Wynik obliczony z obrysu działki. Nie określa możliwości zabudowy."
    },
    "shape_regularity": {
      "value": 1,
      "unit": "ratio",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "area_over_min_rotated_rectangle_v1",
      "coverage": "covered",
      "note": "Wynik obliczony z obrysu działki. Nie określa możliwości zabudowy."
    },
    "squareness": {
      "value": 0.75,
      "unit": "ratio",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "min_rectangle_short_over_long_v1",
      "coverage": "covered",
      "note": "Wynik obliczony z obrysu działki. Nie określa możliwości zabudowy."
    },
    "elongation": {
      "value": 1.333333,
      "unit": "ratio",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "min_rectangle_long_over_short_v1",
      "coverage": "covered",
      "note": "Wynik obliczony z obrysu działki. Nie określa możliwości zabudowy."
    }
  },
  "access_and_roads": {
    "public_road_distance_m": {
      "value": 12.0,
      "unit": "m",
      "source": {
        "id": "bdot_roads",
        "title": "bdot_roads",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), BDOT10k",
        "licence": "open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "polygon_to_public_management_road_cap5000m_v1",
      "coverage": "covered",
      "note": "Wynik geometryczny. Nie potwierdza prawnego dostępu do drogi publicznej."
    },
    "road_access": {
      "value": true,
      "unit": null,
      "source": {
        "id": "bdot_roads",
        "title": "bdot_roads",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), BDOT10k",
        "licence": "open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "dr_shared_boundary_or_public_line_within30m_v1",
      "coverage": "covered",
      "note": "Wynik geometryczny. Nie potwierdza prawnego dostępu do drogi publicznej.",
      "sources": [
        {
          "id": "bdot_roads",
          "title": "bdot_roads",
          "publisher": "Fixture only",
          "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), BDOT10k",
          "licence": "open_data",
          "url": "https://example.test/source",
          "as_of": "2026-10-01"
        },
        {
          "id": "egib_dr_parcels",
          "title": "egib_dr_parcels",
          "publisher": "Fixture only",
          "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
          "licence": "statutory_open_data",
          "url": "https://example.test/source",
          "as_of": "2026-10-01"
        }
      ]
    },
    "frontage_m": {
      "value": 40.0,
      "unit": "m",
      "source": {
        "id": "egib_dr_parcels",
        "title": "egib_dr_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "union_dr_shared_boundary_length_epsg2180_v1",
      "coverage": "covered",
      "note": "Długość wspólnej granicy z działkami oznaczonymi jako drogi. Nie potwierdza prawnego dojazdu."
    }
  },
  "land_use": {
    "land_use_classes": {
      "value": [
        "R",
        "dr"
      ],
      "unit": null,
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "egib_unique_land_use_symbols_v1",
      "coverage": "covered",
      "note": "Nie wczytaliśmy jeszcze klas użytków EGiB dla tej działki."
    },
    "pog_zone_class": {
      "value": null,
      "unit": null,
      "source": {
        "id": "pog_sweep",
        "title": "pog_sweep",
        "publisher": "Fixture only",
        "attribution": "Źródło: uchwały rad gmin w sprawie planu ogólnego, wojewódzkie dzienniki urzędowe; zestawienie: Działkopedia",
        "licence": "local_law_no_copyright",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "dominant_qualified_pog_symbol_v1",
      "coverage": "not_computed",
      "note": "Nie obliczyliśmy jeszcze tej cechy dla działki."
    }
  },
  "buildings_and_surroundings": {
    "buildings_present": {
      "value": true,
      "unit": null,
      "source": {
        "id": "egib_buildings",
        "title": "egib_buildings",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "positive_area_footprint_intersection_v1",
      "coverage": "covered",
      "note": "Budynki według obrysów EGiB. Powierzchnia zabudowy obejmuje część obrysów położoną na działce."
    },
    "building_count": {
      "value": 1,
      "unit": "count",
      "source": {
        "id": "egib_buildings",
        "title": "egib_buildings",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "distinct_positive_area_footprints_v1",
      "coverage": "covered",
      "note": "Budynki według obrysów EGiB. Powierzchnia zabudowy obejmuje część obrysów położoną na działce."
    },
    "building_footprint_m2": {
      "value": 100,
      "unit": "m2",
      "source": {
        "id": "egib_buildings",
        "title": "egib_buildings",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "area_union_clipped_footprints_epsg2180_v1",
      "coverage": "covered",
      "note": "Budynki według obrysów EGiB. Powierzchnia zabudowy obejmuje część obrysów położoną na działce."
    },
    "building_coverage_pct": {
      "value": 8.333333,
      "unit": "percent",
      "source": {
        "id": "egib_buildings",
        "title": "egib_buildings",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "100_clipped_union_area_over_parcel_area_v1",
      "coverage": "covered",
      "note": "Budynki według obrysów EGiB. Powierzchnia zabudowy obejmuje część obrysów położoną na działce."
    },
    "buildings_500m": {
      "value": null,
      "unit": "count",
      "source": {
        "id": "egib_buildings",
        "title": "egib_buildings",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "distinct_footprints_polygon_radius500m_v1",
      "coverage": "not_computed",
      "note": "Nie obliczyliśmy jeszcze tej cechy dla działki."
    }
  },
  "prices_nearby": {
    "rcn_gmina_median_pln_m2": {
      "value": 100,
      "unit": "PLN/m2",
      "source": {
        "id": "rcn_clean_agg",
        "title": "rcn_clean_agg",
        "publisher": "Fixture only",
        "attribution": "Źródło: Rejestr Cen Nieruchomości (GUGiK).",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "fixed_gmina_clean_cohort_k6_median_round50_half_even_v1",
      "coverage": "covered",
      "note": "Dane RCN dla całej gminy, z co najmniej 6 transakcji. Mediana jest zaokrąglona do 50 zł/m². To nie jest wycena działki.; stan rejestru na 1 października 2026 r."
    },
    "rcn_gmina_sales_count": {
      "value": 6,
      "unit": "count",
      "source": {
        "id": "rcn_clean_agg",
        "title": "rcn_clean_agg",
        "publisher": "Fixture only",
        "attribution": "Źródło: Rejestr Cen Nieruchomości (GUGiK).",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "fixed_gmina_clean_distinct_sales_k6_v1",
      "coverage": "covered",
      "note": "Dane RCN dla całej gminy, z co najmniej 6 transakcji. Mediana jest zaokrąglona do 50 zł/m². To nie jest wycena działki.; stan rejestru na 1 października 2026 r."
    }
  },
  "development_activity": {
    "gunb_activity_gmina": {
      "value": 10,
      "unit": "count",
      "source": {
        "id": "gunb_permits",
        "title": "gunb_permits",
        "publisher": "Fixture only",
        "attribution": "Źródło: rejestr RWDZ GUNB",
        "licence": "cc0",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "rwdz_exact_administrative_terc_all_loaded_entries_v1",
      "coverage": "covered",
      "note": "Liczba wpisów w rejestrze RWDZ GUNB przypisanych do gminy. Nie oznacza liczby rozpoczętych budów.; stan rejestru na 1 października 2026 r."
    },
    "gunb_activity_500m": {
      "value": 2,
      "unit": "count_min",
      "source": {
        "id": "gunb_permits",
        "title": "gunb_permits",
        "publisher": "Fixture only",
        "attribution": "Źródło: rejestr RWDZ GUNB",
        "licence": "cc0",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "rwdz_exact_parcel_link_radius500m_lower_bound_v1",
      "coverage": "covered",
      "note": "Liczba jednoznacznie przypisanych wpisów GUNB w odległości do 500 m od granicy działki jest dolną granicą. Wpisy bez jednoznacznego przypisania do działek nie są uwzględnione.; stan rejestru na 1 października 2026 r.",
      "sources": [
        {
          "id": "gunb_permits",
          "title": "gunb_permits",
          "publisher": "Fixture only",
          "attribution": "Źródło: rejestr RWDZ GUNB",
          "licence": "cc0",
          "url": "https://example.test/source",
          "as_of": "2026-10-01"
        },
        {
          "id": "egib_parcels",
          "title": "egib_parcels",
          "publisher": "Fixture only",
          "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
          "licence": "statutory_open_data",
          "url": "https://example.test/source",
          "as_of": "2026-10-01"
        }
      ]
    }
  },
  "amenities": {}
}

GET /v1/search accepts these 12 flat filters with an existing q/id/point/bbox scope or administrative teryt (4-digit powiat or 7-digit gmina). POST accepts polygon, optional limit, cursor and the same flat predicates inside filters. The separate typed SearchRequestV2 area shape and exports remain unavailable.

FilterSchemaDescription
area_min_m2{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.
area_max_m2{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.
land_use_class{"enum": ["R", "Ł", "Ps", "Br", "B", "Ba", "Bi", "Bp", "Bz", "K", "Ls", "Lz", "Lzr", "N", "Wp", "Ws", "Wsr", "W", "dr", "Tk", "Ti", "Tr", "E"], "type": "string"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.
shape_regularity_min{"maximum": 1, "minimum": 0, "type": "number"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.
frontage_min_m{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.
road_access{"type": "boolean"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.
buildings_present{"type": "boolean"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.
public_road_max_m{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.
rcn_price_min_pln_m2{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.
rcn_price_max_pln_m2{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.
gunb_activity_min{"maximum": 1000000000000.0, "minimum": 0, "type": "integer"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.
pog_zone_class{"enum": ["SW", "SJ", "SN", "SU", "SH", "SI", "SZ", "SC", "SG", "SO", "SR", "SK", "SP"], "type": "string"}Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną.

search_facets.scope_count counts the full scope and matched_count the combined AND result. Every active filter reports independent matched, excluded_known and excluded_unknown counts before pagination and other filters. Unknown never passes a predicate, including false; unknown counts overlap and must not be summed.

GET /v1/places?q=War&limit=10 requires a key and costs 0 credits. Prefixes have 2..100 characters; limit defaults to 10 and is at most 20. Matching ignores case and accents, including ł/l. Results distinguish gmina, powiat, obręb and miejscowość, with parent, id, TERYT and parcel coverage. A locality without SIMC has teryt: null; its parent gmina code is not a locality TERYT. See the places reference.