{
  "pack": "diaspora_migrant_stock",
  "title": "Diaspora & migrant stock SEA",
  "as_of": "2026-09-23",
  "timezone": "Europe/London",
  "linear_issue": "MED2-72",
  "coverage_iso3": ["BRN","KHM","IDN","LAO","MYS","MMR","PHL","SGP","THA","VNM","TLS"],
  "sources": [
    {
      "id": "undesa_ims_2024",
      "name": "UNDESA International Migrant Stock 2024 (POP/DB/MIG/Stock/Rev.2024)",
      "url": "https://www.un.org/development/desa/pd/content/international-migrant-stock",
      "files": [
        "undesa_pd_2024_ims_stock_by_sex_and_destination.xlsx",
        "undesa_pd_2024_ims_stock_by_sex_and_origin.xlsx",
        "undesa_pd_2024_ims_stock_by_sex_destination_and_origin.xlsx"
      ],
      "pull_date": "2026-09-23",
      "used_for": [
        "immigrant_stock_total",
        "immigrant_stock_pct_pop",
        "emigrant_stock_total",
        "emigrant_stock_pct_pop",
        "population_midyear",
        "corridor_rank*",
        "timeseries"
      ],
      "notes": "Primary. Mid-year estimates 1990–2024. Emigrant % computed from origin stock / destination Table 2 population."
    },
    {
      "id": "wdi_migrant_stock",
      "name": "World Bank WDI SM.POP.TOTL / SM.POP.TOTL.ZS",
      "api": "https://api.worldbank.org/v2/country/{iso}/indicator/{code}",
      "lastupdated": "2026-07-13",
      "pull_date": "2026-09-23",
      "used_for": ["cross-check immigrant stock"],
      "notes": "SEA-11 mid-2024 totals match UNDESA exactly; cite UNDESA as primary. % series is rounded vs UNDESA Table 3."
    },
    {
      "id": "wdi_net_migration",
      "name": "World Bank WDI SM.POP.NETM",
      "url": "https://data.worldbank.org/indicator/SM.POP.NETM",
      "pull_date": "2026-09-23",
      "used_for": ["net_migration_annual"],
      "notes": "FLOW metric only — excluded from dual stock panels."
    }
  ],
  "rules": [
    "No invented stock or corridor shares",
    "Empty cells stay empty (documented in gaps.md)",
    "Dual story: migrant/diaspora stock ≠ remittance flows — never blur",
    "British English in docs",
    "Singapore hub shown separately from PH peer lens (MY/TH/VN/ID)",
    "Prefer UNDESA citation when WDI matches"
  ],
  "files": [
    "scoreboard.csv",
    "scoreboard_wide.csv",
    "timeseries.csv",
    "gaps.md",
    "README.md",
    "provenance.json"
  ],
  "companion_packs": ["remittances", "labour_youth", "demographics_urbanization", "philippines_peer_card"]
}