← Back to XK country layer · Country index
Synthestat · Kosovo · latest run

xk_population_national_candidate_2024_muni_bf4a4f87_seed420987

Local run directory: /home/synthestat/output/runs/XK/xk_population_national_candidate_2024_muni_bf4a4f87_seed420987

This static page mirrors the run diagnostics/messages so they are clickable from the QA dashboard.

Output status

PeopleHouseholdsDwellingsHouses/buildingsMax marginal deviationHARD statusValidation rows
———————

Run files

FileBytesKind
assignment_diagnostics.json226file
build_manifest.json13,744file
constraint_residuals.json47,158file
distribution_diagnostics.json557file
dwelling_building_diagnostics.json465file
geography_quality_tiers.json10,423file
hidden_population_overlays.unavailable.json626file
household_diagnostics.json15,375file
model_notes.md2,761file
national_candidate_summary.json1,103file
source_provenance.json11,683file
synthetic_building_assignments.unavailable.json454file
synthetic_dwellings.parquet2,075,096file
synthetic_households.parquet1,748,363file
synthetic_persons.parquet7,894,682file
uncertainty_summary.json1,814file
work_school_assignments.unavailable.json458file

Datasets and distributions

Lists come from the latest run bundle: source_provenance.json, distribution_diagnostics.json, and build_manifest.json.

Summary

Datasets used0
Distributions available0
Constraints/distributions used in synthesis3
Constraint types—
Dataset variants—
Finest-geography status—

Source gaps

  • No source gaps listed.

Datasets used

Dataset/source ID
None listed yet.

Best source by distribution family

Distribution familyDataset/source ID
None listed yet.

Available distributions / priors in registry

SpecLabelTypeGeoStatusVariantConfidenceData URI
None listed yet.

Constraints/distributions used in synthesis manifest

Constraint or distribution ID
XK_ASK_CENSUS2024_POPULATION_TOTAL
XK_ASK_CENSUS2024_HOUSEHOLDS_TOTAL
XK_ASK_CENSUS2024_CONVENTIONAL_DWELLINGS_TOTAL

model_notes.md

# XK national-scale population candidate — ASK 2024 municipality controls

Run id: `xk_population_national_candidate_2024_muni_bf4a4f87_seed420987`

This bundle is a Kosovo-wide internal model/reviewer candidate built from provenanced ASK PXWeb exports under `other_branch/data/raw/countries/XK/ask/pxweb_exports`. It is not a production/release artefact.

National targets and row counts:
- Official ASK/KAS 2024 population target: 1,602,515; synthetic persons emitted: 1,602,515; HARD residual 0.
- Official ASK/KAS 2024 household target: 366,595; synthetic households emitted: 366,595; HARD residual 0.
- ASK/KAS 2024 conventional dwelling target: 556,779; synthetic/modelled dwelling records emitted: 556,791; FIRM residual 12 (tolerance 2%).

Model fix applied for this rerun:
- One adult reference person is assigned to each household before any child members, preventing children-alone private households and under-18 reference persons.
- Private 10+ households are capped at 15 persons.
- Municipality-level population that cannot be reconciled with capped private household-size controls is routed to explicit `UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET` rows. These rows are degraded/non-private aggregate buckets, not claimed family households.
- `household_diagnostics.json`, `uncertainty_summary.json`, and `national_candidate_summary.json` define unresolved residual bucket persons as the sum of emitted `synthetic_households.parquet` rows where `household_type == UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET`: 432 rows / 21,510 persons.
- `household_diagnostics.json` reports member-count mismatches, all-child households, underage references, size percentiles/max, municipality residuals, and unresolved bucket totals.

Constraint precedence is preserved: no HARD population or household total was relaxed. C-tier degradation remains visible where Kosovo aggregate controls cannot support stronger household-family realism.

Major caveats:
- Geography is municipality-level only, not settlement/address/building-level.
- No real building IDs or KCA cadastral assignments are integrated; `synthetic_building_assignments.unavailable.json` is explicit.
- Household relationship/family/couple/parent-child realism is not evidenced beyond age-aware role guardrails.
- Hidden-population overlays, work/school/facility assignments, education/employment/occupation/industry/income/origin/nationality/marital-status attributes are unavailable/not generated in this national candidate.
- Source provenance retains validation-catalogue hashes and adds canonical on-disk source-file hashes for the files consumed by this build.

Recommended reviewer verdict category if no further evidence is added: internal national-core inspection only; not external release ready.

build_manifest.json

{
  "country": "XK",
  "run_id": "xk_population_national_candidate_2024_muni_bf4a4f87_seed420987",
  "created_at": "2026-05-19T18:54:17.762248+00:00",
  "project_root": "/home/synthestat",
  "git_commit": "a5ad12d74bcf64a2c256e1fe83d99cc700e02bba-dirty",
  "git_dirty": true,
  "random_seed": 420987,
  "source_catalogue_version": "ASK selected PXWeb exports validation 2026-05-06 plus source hashes in source_provenance.json",
  "geography_version": "ASK census 2024 municipality dimension, 39 entries including national KOSOVA aggregate; 38 municipalities synthesized",
  "classification_crosswalk_versions": {
    "education": "not_generated",
    "occupation": "not_generated",
    "industry": "not_generated"
  },
  "constraints_used": [
    "XK_ASK_CENSUS2024_POPULATION_TOTAL",
    "XK_ASK_CENSUS2024_HOUSEHOLDS_TOTAL",
    "XK_ASK_CENSUS2024_CONVENTIONAL_DWELLINGS_TOTAL"
  ],
  "constraints_relaxed": [
    {
      "source": "ASK census2024 household-size municipality",
      "municipality": "Fushë Kosovë",
      "location_code": "XK_MUNI_009",
      "reason": "Municipality household-size lower-bound total exceeded age-sex population; preserved HARD population and household totals and relaxed FIRM within-municipality size interpretation.",
      "residual_persons": 78,
      "tolerance": "explicitly degraded C-tier municipality candidate; not release-pass"
    },
    {
      "source": "ASK census2024 household-size municipality",
      "municipality": "Kamenicë",
      "location_code": "XK_MUNI_010",
      "reason": "Municipality household-size lower-bound total exceeded age-sex population; preserved HARD population and household totals and relaxed FIRM within-municipality size interpretation.",
      "residual_persons": 43,
      "tolerance": "explicitly degraded C-tier municipality candidate; not release-pass"
    },
    {
      "source": "ASK census2024 household-size municipality",
      "municipality": "Novobërdë",
      "location_code": "XK_MUNI_014",
      "reason": "Municipality household-size lower-bound total exceeded age-sex population; preserved HARD population and household totals and relaxed FIRM within-municipality size interpretation.",
      "residual_persons": 5,
      "tolerance": "explicitly degraded C-tier municipality candidate; not release-pass"
    },
    {
      "source": "ASK census2024 household-size municipality",
      "municipality": "Prishtinë",
      "location_code": "XK_MUNI_019",
      "reason": "Municipality household-size lower-bound total exceeded age-sex population; preserved HARD population and household totals and relaxed FIRM within-municipality size interpretation.",
      "residual_persons": 126,
      "tolerance": "explicitly degraded C-tier municipality candidate; not release-pass"
    },
    {
      "source": "ASK census2024 household-size municipality",
      "municipality": "Shtërpcë",
      "location_code": "XK_MUNI_023",
      "reason": "Municipality household-size lower-bound total exceeded age-sex population; preserved HARD population and household totals and relaxed FIRM within-municipality size interpretation.",
      "residual_persons": 39,
      "tolerance": "explicitly degraded C-tier municipality candidate; not release-pass"
    },
    {
      "source": "ASK census2024 household-size municipality",
      "municipality": "Ranillug",
      "location_code": "XK_MUNI_035",
      "reason": "Municipality household-size lower-bound total exceeded age-sex population; preserved HARD population and household totals and relaxed FIRM within-municipality size interpretation.",
      "residual_persons": 5,
      "tolerance": "explicitly degraded C-tier municipality candidate; not release-pass"
    },
    {
      "source": "ASK census2024 household-size municipality",
      "municipality": "Partesh",
      "location_code": "XK_MUNI_036",
      "reason": "Municipality household-size lower-bound total exceeded age-sex population; preserved HARD population and household totals and relaxed FIRM within-municipality size interpretation.",
      "residual_persons": 2,
      "tolerance": "explicitly degraded C-tier municipality candidate; not release-pass"
    }
  ],
  "zones_degraded": [
    {
      "location_code": "XK_MUNI_001",
      "municipality": "Deçan",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_002",
      "municipality": "Gjakovë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_003",
      "municipality": "Gllogovc",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_004",
      "municipality": "Gjilan",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_005",
      "municipality": "Dragash",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_006",
      "municipality": "Istog",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_007",
      "municipality": "Kaçanik",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_008",
      "municipality": "Klinë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_009",
      "municipality": "Fushë Kosovë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_010",
      "municipality": "Kamenicë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_011",
      "municipality": "Mitrovicë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_012",
      "municipality": "Leposaviq",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_013",
      "municipality": "Lipjan",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_014",
      "municipality": "Novobërdë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_015",
      "municipality": "Obiliq",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_016",
      "municipality": "Rahovec",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_017",
      "municipality": "Pejë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_018",
      "municipality": "Podujevë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_019",
      "municipality": "Prishtinë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_020",
      "municipality": "Prizren",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_021",
      "municipality": "Skenderaj",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_022",
      "municipality": "Shtime",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_023",
      "municipality": "Shtërpcë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_024",
      "municipality": "Suharekë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_025",
      "municipality": "Ferizaj",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_026",
      "municipality": "Viti",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_027",
      "municipality": "Vushtrri",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_028",
      "municipality": "Zubin Potok",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_029",
      "municipality": "Zveqan",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_030",
      "municipality": "Malishevë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_031",
      "municipality": "Junik",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_032",
      "municipality": "Mamushë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_033",
      "municipality": "Hani i Elezit",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_034",
      "municipality": "Graçanicë",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_035",
      "municipality": "Ranillug",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_036",
      "municipality": "Partesh",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_037",
      "municipality": "Kllokot",
      "quality_tier": "C",
      "reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "location_code": "XK_MUNI_038",
      "municipality": "Mitrovica Veriore",
      "quality_tier": "C",
      "reason"

… truncated after 12,000 characters …

constraint_residuals.json

{
  "country": "XK",
  "run_id": "xk_population_national_candidate_2024_muni_bf4a4f87_seed420987",
  "hard_constraint_broken_rows": [],
  "residuals": [
    {
      "constraint_id": "XK_ASK_CENSUS2024_POPULATION_TOTAL",
      "level": "HARD",
      "target": 1602515,
      "observed": 1602515,
      "residual": 0,
      "status": "PASS"
    },
    {
      "constraint_id": "XK_ASK_CENSUS2024_HOUSEHOLDS_TOTAL",
      "level": "HARD",
      "target": 366595,
      "observed": 366595,
      "residual": 0,
      "status": "PASS"
    },
    {
      "constraint_id": "XK_ASK_CENSUS2024_CONVENTIONAL_DWELLINGS_TOTAL",
      "level": "FIRM",
      "target": 556779,
      "observed": 556791,
      "residual": 12,
      "relative_error": 2.1552537003011966e-05,
      "status": "PASS"
    }
  ],
  "municipality_diagnostics": [
    {
      "municipality": "Deçan",
      "location_code": "XK_MUNI_001",
      "population_2024_age_sex_sum": 27775,
      "households_2024_total": 5909,
      "household_size_min_persons_before_10plus_allocation": 27315,
      "private_extra_persons_allocated_to_10plus_cap": 460,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "unresolved_residual_bucket_definition": "count and persons are computed from household rows where household_type/is_unresolved_bucket is UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET; persons equals the sum of emitted bucket row size values",
      "firm_household_size_person_shortfall_relaxed": 0,
      "max_private_household_size_cap": 15,
      "max_unresolved_bucket_size_soft_cap": 50,
      "conventional_dwellings_2024": 9839,
      "vacant_dwellings_2024": 3030,
      "occupied_household_linked_dwellings_emitted": 5909,
      "vacant_dwellings_emitted": 3030,
      "unlinked_conventional_dwelling_residual_emitted": 900,
      "quality_tier": "C",
      "degradation_reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "municipality": "Gjakovë",
      "location_code": "XK_MUNI_002",
      "population_2024_age_sex_sum": 78699,
      "households_2024_total": 18538,
      "household_size_min_persons_before_10plus_allocation": 77761,
      "private_extra_persons_allocated_to_10plus_cap": 938,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "unresolved_residual_bucket_definition": "count and persons are computed from household rows where household_type/is_unresolved_bucket is UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET; persons equals the sum of emitted bucket row size values",
      "firm_household_size_person_shortfall_relaxed": 0,
      "max_private_household_size_cap": 15,
      "max_unresolved_bucket_size_soft_cap": 50,
      "conventional_dwellings_2024": 26628,
      "vacant_dwellings_2024": 8360,
      "occupied_household_linked_dwellings_emitted": 18538,
      "vacant_dwellings_emitted": 8090,
      "unlinked_conventional_dwelling_residual_emitted": 0,
      "quality_tier": "C",
      "degradation_reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "municipality": "Gllogovc",
      "location_code": "XK_MUNI_003",
      "population_2024_age_sex_sum": 48079,
      "households_2024_total": 9878,
      "household_size_min_persons_before_10plus_allocation": 47765,
      "private_extra_persons_allocated_to_10plus_cap": 314,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "unresolved_residual_bucket_definition": "count and persons are computed from household rows where household_type/is_unresolved_bucket is UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET; persons equals the sum of emitted bucket row size values",
      "firm_household_size_person_shortfall_relaxed": 0,
      "max_private_household_size_cap": 15,
      "max_unresolved_bucket_size_soft_cap": 50,
      "conventional_dwellings_2024": 12910,
      "vacant_dwellings_2024": 2725,
      "occupied_household_linked_dwellings_emitted": 9878,
      "vacant_dwellings_emitted": 2725,
      "unlinked_conventional_dwelling_residual_emitted": 307,
      "quality_tier": "C",
      "degradation_reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "municipality": "Gjilan",
      "location_code": "XK_MUNI_004",
      "population_2024_age_sex_sum": 82980,
      "households_2024_total": 19897,
      "household_size_min_persons_before_10plus_allocation": 82909,
      "private_extra_persons_allocated_to_10plus_cap": 71,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "unresolved_residual_bucket_definition": "count and persons are computed from household rows where household_type/is_unresolved_bucket is UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET; persons equals the sum of emitted bucket row size values",
      "firm_household_size_person_shortfall_relaxed": 0,
      "max_private_household_size_cap": 15,
      "max_unresolved_bucket_size_soft_cap": 50,
      "conventional_dwellings_2024": 32578,
      "vacant_dwellings_2024": 12656,
      "occupied_household_linked_dwellings_emitted": 19897,
      "vacant_dwellings_emitted": 12656,
      "unlinked_conventional_dwelling_residual_emitted": 25,
      "quality_tier": "C",
      "degradation_reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "municipality": "Dragash",
      "location_code": "XK_MUNI_005",
      "population_2024_age_sex_sum": 28896,
      "households_2024_total": 7132,
      "household_size_min_persons_before_10plus_allocation": 28615,
      "private_extra_persons_allocated_to_10plus_cap": 281,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "unresolved_residual_bucket_definition": "count and persons are computed from household rows where household_type/is_unresolved_bucket is UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET; persons equals the sum of emitted bucket row size values",
      "firm_household_size_person_shortfall_relaxed": 0,
      "max_private_household_size_cap": 15,
      "max_unresolved_bucket_size_soft_cap": 50,
      "conventional_dwellings_2024": 10817,
      "vacant_dwellings_2024": 4693,
      "occupied_household_linked_dwellings_emitted": 7132,
      "vacant_dwellings_emitted": 3685,
      "unlinked_conventional_dwelling_residual_emitted": 0,
      "quality_tier": "C",
      "degradation_reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "municipality": "Istog",
      "location_code": "XK_MUNI_006",
      "population_2024_age_sex_sum": 33008,
      "households_2024_total": 7591,
      "household_size_min_persons_before_10plus_allocation": 32672,
      "private_extra_persons_allocated_to_10plus_cap": 336,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "unresolved_residual_bucket_definition": "count and persons are computed from household rows where household_type/is_unresolved_bucket is UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET; persons equals the sum of emitted bucket row size values",
      "firm_household_size_person_shortfall_relaxed": 0,
      "max_private_household_size_cap": 15,
      "max_unresolved_bucket_size_soft_cap": 50,
      "conventional_dwellings_2024": 13084,
      "vacant_dwellings_2024": 5385,
      "occupied_household_linked_dwellings_emitted": 7591,
      "vacant_dwellings_emitted": 5385,
      "unlinked_conventional_dwelling_residual_emitted": 108,
      "quality_tier": "C",
      "degradation_reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "municipality": "Kaçanik",
      "location_code": "XK_MUNI_007",
      "population_2024_age_sex_sum": 27716,
      "households_2024_total": 5908,
      "household_size_min_persons_before_10plus_allocation": 27636,
      "private_extra_persons_allocated_to_10plus_cap": 80,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "unresolved_residual_bucket_definition": "count and persons are computed from household rows where household_type/is_unresolved_bucket is UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET; persons equals the sum of emitted bucket row size values",
      "firm_household_size_person_shortfall_relaxed": 0,
      "max_private_household_size_cap": 15,
      "max_unresolved_bucket_size_soft_cap": 50,
      "conventional_dwellings_2024": 8276,
      "vacant_dwellings_2024": 2449,
      "occupied_household_linked_dwellings_emitted": 5908,
      "vacant_dwellings_emitted": 2368,
      "unlinked_conventional_dwelling_residual_emitted": 0,
      "quality_tier": "C",
      "degradation_reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "municipality": "Klinë",
      "location_code": "XK_MUNI_008",
      "population_2024_age_sex_sum": 30503,
      "households_2024_total": 6753,
      "household_size_min_persons_before_10plus_allocation": 30370,
      "private_extra_persons_allocated_to_10plus_cap": 133,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "unresolved_residual_bucket_definition": "count and persons are computed from household rows where household_type/is_unresolved_bucket is UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET; persons equals the sum of emitted bucket row size values",
      "firm_household_size_person_shortfall_relaxed": 0,
      "max_private_household_size_cap": 15,
      "max_unresolved_bucket_size_soft_cap": 50,
      "conventional_dwellings_2024": 11192,
      "vacant_dwellings_2024": 4514,
      "occupied_household_linked_dwellings_emitted": 6753,
      "vacant_dwellings_emitted": 4439,
      "unlinked_conventional_dwelling_residual_emitted": 0,
      "quality_tier": "C",
      "degradation_reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "municipality": "Fushë Kosovë",
      "location_code": "XK_MUNI_009",
      "population_2024_age_sex_sum": 63949,
      "households_2024_total": 16085,
      "household_size_min_persons_before_10plus_allocation": 64027,
      "private_extra_persons_allocated_to_10plus_cap": 0,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "unresolved_residual_bucket_definition": "count and persons are computed from household rows where household_type/is_unresolved_bucket is UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET; persons equals the sum of emitted bucket row size values",
      "firm_household_size_person_shortfall_relaxed": 78,
      "max_private_household_size_cap": 15,
      "max_unresolved_bucket_size_soft_cap": 50,
      "conventional_dwellings_2024": 27628,
      "vacant_dwellings_2024": 10597,
      "occupied_household_linked_dwellings_emitted": 16085,
      "vacant_dwellings_emitted": 10597,
      "unlinked_conventional_dwelling_residual_emitted": 946,
      "quality_tier": "C",
      "degradation_reason": "municipality aggregate controls only; no settlement/building/person microdata"
    },
    {
      "municipality": "Kamenicë",
      "location_code": "XK_MUNI_010",
      "population_2024_age_sex_sum": 22868,
      "households_2024_total": 5940,
      "household_size_min_persons_before_

… truncated after 12,000 characters …

household_diagnostics.json

{
  "country": "XK",
  "run_id": "xk_population_national_candidate_2024_muni_bf4a4f87_seed420987",
  "households": 366595,
  "status": "age_aware_private_household_assignment_with_explicit_unresolved_residual_buckets",
  "member_count_vs_household_size_mismatches": 0,
  "member_count_mismatch_examples": [],
  "all_under15_households": 0,
  "single_under15_households": 0,
  "all_child_households_under18": 0,
  "under18_reference_persons": 0,
  "household_size_percentiles_all_rows": {
    "p50": 4,
    "p90": 7,
    "p95": 8,
    "p99": 10,
    "max": 50
  },
  "private_household_size_percentiles": {
    "p50": 4,
    "p90": 7,
    "p95": 8,
    "p99": 10,
    "max": 15
  },
  "private_household_size_cap": 15,
  "private_households_over_cap": 0,
  "unresolved_residual_bucket_count": 432,
  "unresolved_residual_bucket_persons": 21510,
  "unresolved_residual_bucket_definition": "count/person diagnostics use emitted synthetic_households rows with household_type == UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET; persons is the sum of those rows' size values, not only the incremental excess above the original private-household category size",
  "unresolved_residual_bucket_size_percentiles": {
    "p50": 50,
    "p90": 50,
    "p95": 50,
    "p99": 50,
    "max": 50
  },
  "municipality_residuals": [
    {
      "municipality": "De\u00e7an",
      "location_code": "XK_MUNI_001",
      "private_extra_persons_allocated_to_10plus_cap": 460,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Gjakov\u00eb",
      "location_code": "XK_MUNI_002",
      "private_extra_persons_allocated_to_10plus_cap": 938,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Gllogovc",
      "location_code": "XK_MUNI_003",
      "private_extra_persons_allocated_to_10plus_cap": 314,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Gjilan",
      "location_code": "XK_MUNI_004",
      "private_extra_persons_allocated_to_10plus_cap": 71,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Dragash",
      "location_code": "XK_MUNI_005",
      "private_extra_persons_allocated_to_10plus_cap": 281,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Istog",
      "location_code": "XK_MUNI_006",
      "private_extra_persons_allocated_to_10plus_cap": 336,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Ka\u00e7anik",
      "location_code": "XK_MUNI_007",
      "private_extra_persons_allocated_to_10plus_cap": 80,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Klin\u00eb",
      "location_code": "XK_MUNI_008",
      "private_extra_persons_allocated_to_10plus_cap": 133,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Fush\u00eb Kosov\u00eb",
      "location_code": "XK_MUNI_009",
      "private_extra_persons_allocated_to_10plus_cap": 0,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 78
    },
    {
      "municipality": "Kamenic\u00eb",
      "location_code": "XK_MUNI_010",
      "private_extra_persons_allocated_to_10plus_cap": 0,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 43
    },
    {
      "municipality": "Mitrovic\u00eb",
      "location_code": "XK_MUNI_011",
      "private_extra_persons_allocated_to_10plus_cap": 118,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Leposaviq",
      "location_code": "XK_MUNI_012",
      "private_extra_persons_allocated_to_10plus_cap": 45,
      "unresolved_residual_persons_routed_to_explicit_buckets": 6237,
      "unresolved_residual_bucket_count": 144,
      "unresolved_residual_bucket_persons": 7161,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Lipjan",
      "location_code": "XK_MUNI_013",
      "private_extra_persons_allocated_to_10plus_cap": 186,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Novob\u00ebrd\u00eb",
      "location_code": "XK_MUNI_014",
      "private_extra_persons_allocated_to_10plus_cap": 0,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 5
    },
    {
      "municipality": "Obiliq",
      "location_code": "XK_MUNI_015",
      "private_extra_persons_allocated_to_10plus_cap": 76,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Rahovec",
      "location_code": "XK_MUNI_016",
      "private_extra_persons_allocated_to_10plus_cap": 490,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Pej\u00eb",
      "location_code": "XK_MUNI_017",
      "private_extra_persons_allocated_to_10plus_cap": 571,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Podujev\u00eb",
      "location_code": "XK_MUNI_018",
      "private_extra_persons_allocated_to_10plus_cap": 479,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Prishtin\u00eb",
      "location_code": "XK_MUNI_019",
      "private_extra_persons_allocated_to_10plus_cap": 0,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 126
    },
    {
      "municipality": "Prizren",
      "location_code": "XK_MUNI_020",
      "private_extra_persons_allocated_to_10plus_cap": 2107,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Skenderaj",
      "location_code": "XK_MUNI_021",
      "private_extra_persons_allocated_to_10plus_cap": 538,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Shtime",
      "location_code": "XK_MUNI_022",
      "private_extra_persons_allocated_to_10plus_cap": 176,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Sht\u00ebrpc\u00eb",
      "location_code": "XK_MUNI_023",
      "private_extra_persons_allocated_to_10plus_cap": 0,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 39
    },
    {
      "municipality": "Suharek\u00eb",
      "location_code": "XK_MUNI_024",
      "private_extra_persons_allocated_to_10plus_cap": 167,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Ferizaj",
      "location_code": "XK_MUNI_025",
      "private_extra_persons_allocated_to_10plus_cap": 218,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Viti",
      "location_code": "XK_MUNI_026",
      "private_extra_persons_allocated_to_10plus_cap": 129,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Vushtrri",
      "location_code": "XK_MUNI_027",
      "private_extra_persons_allocated_to_10plus_cap": 125,
      "unresolved_residual_persons_routed_to_explicit_buckets": 0,
      "unresolved_residual_bucket_count": 0,
      "unresolved_residual_bucket_persons": 0,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Zubin Potok",
      "location_code": "XK_MUNI_028",
      "private_extra_persons_allocated_to_10plus_cap": 0,
      "unresolved_residual_persons_routed_to_explicit_buckets": 2622,
      "unresolved_residual_bucket_count": 60,
      "unresolved_residual_bucket_persons": 2981,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Zveqan",
      "location_code": "XK_MUNI_029",
      "private_extra_persons_allocated_to_10plus_cap": 10,
      "unresolved_residual_persons_routed_to_explicit_buckets": 2422,
      "unresolved_residual_bucket_count": 55,
      "unresolved_residual_bucket_persons": 2748,
      "firm_household_size_person_shortfall_relaxed": 0
    },
    {
      "municipality": "Malishev\u00eb",
      "location_code": "XK_MUNI_030",
      "private_extra_persons_allocated_to_10plus_cap": 1163,
      "unresolved_residual_persons_routed

… truncated after 12,000 characters …

dwelling_building_diagnostics.json

{
  "country": "XK",
  "run_id": "xk_population_national_candidate_2024_muni_bf4a4f87_seed420987",
  "dwellings": 556791,
  "building_assignments": "unavailable",
  "building_assignment_reason": "No real building/address IDs integrated.",
  "national_targets": {
    "population_2024": 1602515,
    "households_2024": 366595,
    "buildings_with_habitable_dwelling_2024": 274116,
    "conventional_dwellings_2024": 556779,
    "vacant_dwellings_2024": 182849
  }
}

distribution_diagnostics.json

{
  "country": "XK",
  "run_id": "xk_population_national_candidate_2024_muni_bf4a4f87_seed420987",
  "diagnostics": {
    "population_age_sex": "ASK 2024 municipality age-sex HARD controls exact",
    "household_size": "ASK 2024 municipality household-size counts used with capped private 10+ allocation and explicit unresolved residual buckets where aggregate controls conflict",
    "dwelling_counts": "ASK 2024 conventional dwelling FIRM residual 12 (0.00215525%)",
    "all_other_distributions": "unavailable_not_generated_for_national_candidate"
  }
}

uncertainty_summary.json

{
  "country": "XK",
  "run_id": "xk_population_national_candidate_2024_muni_bf4a4f87_seed420987",
  "uncertainty_policy": "Official aggregate counts used as HARD/FIRM controls; unobserved household-internal composition is modelled with numeric caps/tolerances and unresolved residual buckets instead of silent precision.",
  "intervals": [
    {
      "quantity": "population_total_2024",
      "estimate": 1602515,
      "source": "ASK census 2024",
      "uncertainty": "official census aggregate treated as fixed HARD control for candidate build",
      "numeric_tolerance": 0
    },
    {
      "quantity": "household_total_2024",
      "estimate": 366595,
      "source": "ASK census 2024",
      "uncertainty": "official census aggregate treated as fixed HARD control for candidate build",
      "numeric_tolerance": 0
    },
    {
      "quantity": "private_household_internal_size",
      "estimate": null,
      "lower_bound": 1,
      "upper_bound": 15,
      "numeric_tolerance": 0,
      "uncertainty": "modelled from ASK household-size categories; 10+ top-code capped at 15 for private households"
    },
    {
      "quantity": "unresolved_aggregate_residual_persons",
      "estimate": 21510,
      "source": "difference between municipality population and capped private household-size capacity",
      "numeric_tolerance": 0,
      "uncertainty": "explicit degraded bucket; not family/private-household realism"
    },
    {
      "quantity": "conventional_dwelling_total",
      "estimate": 556791,
      "target": 556779,
      "residual": 12,
      "relative_error": 2.1552537003011966e-05,
      "firm_tolerance": 0.02
    },
    {
      "quantity": "unobserved_attribute_layers",
      "estimate": null,
      "uncertainty": "not estimated; unavailable to avoid false precision"
    }
  ]
}

source_provenance.json

{
  "country": "XK",
  "run_id": "xk_population_national_candidate_2024_muni_bf4a4f87_seed420987",
  "created_at": "2026-05-19T18:54:17.762248+00:00",
  "source_owner": "Kosovo Agency of Statistics (ASK/KAS)",
  "api_root": "https://askdata.rks-gov.net/api/v1/en/ASKdata",
  "retrieval_validation_timestamp_utc": "2026-05-06T09:47:39.736780+00:00",
  "reference_period": "2024 census tables (with 2011 comparators in source tables where exposed)",
  "geography_level": "municipality plus KOSOVA national aggregate; no settlement/building identifiers integrated",
  "source_files": {
    "population_age_sex_municipality_jsonstat2": {
      "path": "/home/synthestat/other_branch/data/raw/countries/XK/ask/pxweb_exports/census2024_population_age_sex_municipality.jsonstat2.json",
      "sha256": "27bb00d2e5326f4d44e0327e6b9d2c76829a6e1065d2ce12103e291f0dc80c04"
    },
    "population_age_sex_municipality_metadata": {
      "path": "/home/synthestat/other_branch/data/raw/countries/XK/ask/pxweb_exports/census2024_population_age_sex_municipality.metadata.json",
      "sha256": "9e61b21ed81e6d5e193fabf040c742d0c8e37cfd8e4a3bff25b0052c534ece1f"
    },
    "household_size_municipality_jsonstat2": {
      "path": "/home/synthestat/other_branch/data/raw/countries/XK/ask/pxweb_exports/census2024_household_size_municipality.jsonstat2.json",
      "sha256": "e19e5b72b31c095a2cd28a38806387f576302c9f14c5e803284825bff4b6ad82"
    },
    "household_size_municipality_metadata": {
      "path": "/home/synthestat/other_branch/data/raw/countries/XK/ask/pxweb_exports/census2024_household_size_municipality.metadata.json",
      "sha256": "2c4d24b6e8418834a7a4862db3524509b6b8f2451c856b3c639537245465c068"
    },
    "buildings_dwellings_vacancy_municipality_jsonstat2": {
      "path": "/home/synthestat/other_branch/data/raw/countries/XK/ask/pxweb_exports/census2024_buildings_dwellings_vacancy_municipality.jsonstat2.json",
      "sha256": "3a5527eb2c118132b770d294d40be9b227e23971da8fff6b8956ef1ae16decd0"
    },
    "buildings_dwellings_vacancy_municipality_metadata": {
      "path": "/home/synthestat/other_branch/data/raw/countries/XK/ask/pxweb_exports/census2024_buildings_dwellings_vacancy_municipality.metadata.json",
      "sha256": "c8c04154bf8f31c07881a290fc27da5d4d787daced328356efaafc246a8b93e7"
    },
    "ask_selected_export_validation": {
      "path": "/home/synthestat/other_branch/catalogue/source_validations/xk_ask_pxweb_selected_exports_20260506.json",
      "sha256": "a0e570f7c4df51310a7602cfa9a21179ff0a14690c581747e058db661fa9e852"
    }
  },
  "quality_flags": [
    "official_pxweb_aggregate_controls",
    "partial_methodology_fit",
    "municipality_level_only",
    "no_microdata",
    "no_building_ids",
    "no_hidden_population_bounds"
  ],
  "records_used_hash_semantics": "records_used dataset_sha256/metadata_sha256 are retained from the 2026-05-06 validation catalogue; canonical source_files below are the on-disk artefacts consumed by this build and include absolute paths. For the three consumed records, canonical_source_file_sha256 fields are added for direct reconciliation.",
  "records_used": [
    {
      "id": "census2024_population_age_sex_municipality",
      "folders": [
        "Census population",
        "1_Demographic_Characteristics"
      ],
      "table": "census2024_00.px",
      "target_layers": [
        "people"
      ],
      "fit": "partial",
      "why_selected": "Current 2024 and comparator 2011 population controls by municipality, sex and single year of age.",
      "api_url": "https://askdata.rks-gov.net/api/v1/en/ASKdata/Census%20population/1_Demographic_Characteristics/census2024_00.px",
      "metadata_path": "data/raw/countries/XK/ask/pxweb_exports/census2024_population_age_sex_municipality.metadata.json",
      "dataset_path": "data/raw/countries/XK/ask/pxweb_exports/census2024_population_age_sex_municipality.jsonstat2.json",
      "metadata_sha256": "a898992aec4f13651f04152a2849370bf39077fd40c7c50acb093e0425b063a9",
      "dataset_sha256": "5838673ffe60b1b2d1ef28049de9817d4a1a7f749dc9b1e5735d18387eeaefa8",
      "metadata_title": "Population by age, sex and municipality, 2011 and 2024",
      "dataset_label": "Number of population by Year, Municipality, Sex and Age",
      "dataset_source": "Kosovo Agency of Statistics",
      "dataset_updated": "2025-01-17T07:00:00Z",
      "expected_cell_slots": 20358,
      "total_slots_returned": 20358,
      "present_value_count": 19314,
      "numeric_value_count": 19314,
      "numeric_sum": 26738720,
      "dimensions": [
        {
          "code": "Viti",
          "text": "Year",
          "value_count": 2,
          "sample_values": [
            "2011",
            "2024"
          ]
        },
        {
          "code": "Komuna",
          "text": "Municipality",
          "value_count": 39,
          "sample_values": [
            "KOSOVA",
            "Deçan",
            "Gjakovë",
            "Gllogovc",
            "Gjilan",
            "Dragash",
            "Istog",
            "Kaçanik"
          ]
        },
        {
          "code": "Gjinia",
          "text": "Sex",
          "value_count": 3,
          "sample_values": [
            "Total",
            "Male",
            "Female"
          ]
        },
        {
          "code": "Mosha",
          "text": "Age",
          "value_count": 87,
          "sample_values": [
            "0",
            "1",
            "2",
            "3",
            "4",
            "5",
            "6",
            "7"
          ]
        }
      ],
      "canonical_dataset_sha256": "27bb00d2e5326f4d44e0327e6b9d2c76829a6e1065d2ce12103e291f0dc80c04",
      "canonical_metadata_sha256": "9e61b21ed81e6d5e193fabf040c742d0c8e37cfd8e4a3bff25b0052c534ece1f",
      "hash_reconciliation": "canonical_* hashes are computed from the absolute on-disk build inputs; legacy *_sha256 fields are catalogue validation hashes kept for audit continuity"
    },
    {
      "id": "census2024_household_size_municipality",
      "folders": [
        "Census population",
        "5_Ndërtesat, banesat dhe ekonomitë familjare"
      ],
      "table": "census2024_52.px",
      "target_layers": [
        "households"
      ],
      "fit": "partial",
      "why_selected": "Private-household size controls by municipality for 2011 and 2024.",
      "api_url": "https://askdata.rks-gov.net/api/v1/en/ASKdata/Census%20population/5_Nd%C3%ABrtesat%2C%20banesat%20dhe%20ekonomit%C3%AB%20familjare/census2024_52.px",
      "metadata_path": "data/raw/countries/XK/ask/pxweb_exports/census2024_household_size_municipality.metadata.json",
      "dataset_path": "data/raw/countries/XK/ask/pxweb_exports/census2024_household_size_municipality.jsonstat2.json",
      "metadata_sha256": "dbbdbe39db785af77e8e7bf4f21d1b18a0339abe66990ff15ab5a8486451cbc1",
      "dataset_sha256": "5bc5d8ebc4a6fecbe27c2d653dea76441d644c2d05fa0ddb2f980492375a848f",
      "metadata_title": "Household economies by number of members and municipality at the national and municipal level for the years 2011 and 2024.",
      "dataset_label": "Ekonomitë Familjare sipas numrit të anëtarëve dhe komunës by Year, Municipality and Number of household members",
      "dataset_source": "Kosovo Agency of Statistics",
      "dataset_updated": "2016-06-28T07:00:00Z",
      "expected_cell_slots": 858,
      "total_slots_returned": 858,
      "present_value_count": 426,
      "numeric_value_count": 426,
      "numeric_sum": 1466380,
      "dimensions": [
        {
          "code": "Year",
          "text": "Year",
          "value_count": 2,
          "sample_values": [
            "2024",
            "2021"
          ]
        },
        {
          "code": "Municipality",
          "text": "Municipality",
          "value_count": 39,
          "sample_values": [
            "KOSOVA",
            "Deçan",
            "Gjakovë",
            "Gllogoc",
            "Gjilan",
            "Dragash",
            "Istog",
            "Kaçanik"
          ]
        },
        {
          "code": "Number of household members",
          "text": "Number of household members",
          "value_count": 11,
          "sample_values": [
            "Total",
            "1",
            "2",
            "3",
            "4",
            "5",
            "6",
            "7"
          ]
        }
      ],
      "canonical_dataset_sha256": "e19e5b72b31c095a2cd28a38806387f576302c9f14c5e803284825bff4b6ad82",
      "canonical_metadata_sha256": "2c4d24b6e8418834a7a4862db3524509b6b8f2451c856b3c639537245465c068",
      "hash_reconciliation": "canonical_* hashes are computed from the absolute on-disk build inputs; legacy *_sha256 fields are catalogue validation hashes kept for audit continuity"
    },
    {
      "id": "census2024_buildings_dwellings_vacancy_municipality",
      "folders": [
        "Census population",
        "5_Ndërtesat, banesat dhe ekonomitë familjare"
      ],
      "table": "census2024_51.px",
      "target_layers": [
        "buildings",
        "households"
      ],
      "fit": "partial",
      "why_selected": "Municipality-level building and dwelling counts, including inhabited/vacant dwelling variables.",
      "api_url": "https://askdata.rks-gov.net/api/v1/en/ASKdata/Census%20population/5_Nd%C3%ABrtesat%2C%20banesat%20dhe%20ekonomit%C3%AB%20familjare/census2024_51.px",
      "metadata_path": "data/raw/countries/XK/ask/pxweb_exports/census2024_buildings_dwellings_vacancy_municipality.metadata.json",
      "dataset_path": "data/raw/countries/XK/ask/pxweb_exports/census2024_buildings_dwellings_vacancy_municipality.jsonstat2.json",
      "metadata_sha256": "0829a31f1c85acea0afcd9ce36be8edcaf7b6af7a0d82c2ea9202f68f09c519b",
      "dataset_sha256": "a38c872b8989d778dac11f9835f34a2878d71bc2f8bbdf95bb45b067738adb90",
      "metadata_title": "Buildings and dwellings (inhabited and vacant) at the national and municipal level for the years 2011 and 202",
      "dataset_label": "Ndërtesat dhe banesat (të banuara dhe të zbrazëta) by Municipality, Year and Select the variable",
      "dataset_source": "ASK",
      "dataset_updated": "2025-01-21T07:00:00Z",
      "expected_cell_slots": 312,
      "total_slots_returned": 312,
      "present_value_count": 296,
      "numeric_value_count": 296,
      "numeric_sum": 3348536.9,
      "dimensions": [
        {
          "code": "Komuna",
          "text": "Municipality",
          "value_count": 39,
          "sample_values": [
            "KOSOVA",
            "Deçan",
            "Gjakovë",
            "Gllogoc",
            "Gjilan",
            "Dragash",
            "Istog",
            "Kaçanik"
          ]
        },
        {
          "code": "Viti",
          "text": "Year",
          "value_count": 2,
          "sample_values": [
            "2024",
            "2011"
          ]
        },
        {
          "code": "Zgjidh variablin",
          "text": "Select the variable",
          "value_count": 4,
          "sample_values": [
            "uilding with at least one habitable conventional dwelling",
            "Average number of dwellings per building (%)",
            "Number of conventional dwellings",
            "Number of vacant dwellings"
          ]
        }
      ],
      "canonical_dataset_sha256": "3a5527eb2c118132b770d294d40be9b227e23971da8fff6b8956ef1ae16decd0",
      "canonical_metadata_sha256": "c8c04154bf8f31c07881a290fc27da5d4d787daced328356efaafc246a8b93e7",
      "hash_reconciliation": "canonical_* hashes are computed from the absolute on-disk build inputs; legacy *_sha256 fields are catalogue validation hashes kept for audit continuity"
    }
  ]
}