{
  "schema_version": "1.0.0",
  "api_version": "v1",
  "snapshot_id": "bctl-7eb7c1c7524bb525d233",
  "edition": {
    "name": "Civometra Index",
    "label": "2026 Q4",
    "status": "research",
    "methodology_version": "1.0.0",
    "official_city_results_released": false
  },
  "as_of": "2026-10-27",
  "as_of_meaning": "Last complete source check recorded in the research snapshot; not a common observation period or a new editorial review. A separately validated source may have a later retrieved_at date; inspect each observation.",
  "dates": {
    "source_checked_at": "2026-10-27",
    "last_complete_source_check_at": "2026-10-27",
    "latest_observation_retrieved_at": "2026-10-27",
    "observations_changed_at": "2026-10-21",
    "editorial_review_earliest": "2026-10-11",
    "editorial_review_latest": "2026-10-27",
    "urban_context_retrieved_at": "2026-10-26",
    "index_evidence_evaluated_at": "2026-10-27",
    "air_quality_retrieved_at": "2026-10-26",
    "geography_candidates_evaluated_at": "2026-10-26",
    "protocols_prepared_at": "2026-10-26",
    "scoring_geographies_reviewed_at": "2026-10-26",
    "pm25_evidence_reviewed_at": "2026-10-26",
    "heat_evidence_reviewed_at": "2026-10-26",
    "rental_vacancy_evidence_reviewed_at": "2026-10-26",
    "housing_supply_evidence_reviewed_at": "2026-10-26",
    "life_expectancy_evidence_reviewed_at": "2026-10-26",
    "road_deaths_evidence_reviewed_at": "2026-10-27"
  },
  "publisher": {
    "name": "BestCityToLive Intelligence",
    "initiative": "AINT.app",
    "url": "https://aint.app"
  },
  "notice": "Civometra is a research edition, with no official quarterly city results. Current engine-accepted index inputs are explicitly separated from editorial guides, contextual observations and inherited legacy scores. An accepted indicator does not establish an eligible city score or ranking. National context never measures a city.",
  "rights": "No new licence is granted by this API. BestCityToLive editorial material retains its existing rights. Third-party observations and sources retain their own licences and attribution requirements; consult each primary publisher before reuse. Source catalog links do not imply permission to reproduce full source content.",
  "kind": "country",
  "id": "country:CAN",
  "self": "https://bestcitytolive.com/api/v1/countries/canada.json",
  "canonical_url": "https://bestcitytolive.com/country/canada",
  "slug": "canada",
  "name": "Canada",
  "original_id": 2,
  "iso_2": "CA",
  "iso_3": "CAN",
  "continent": "North America",
  "coverage_notice": "Coverage means these published city dossiers are available. It is not a nationally complete city sample, a country travel advisory, a country ranking or a comparative national score.",
  "citation": {
    "title": "Canada: City Intelligence Coverage",
    "author": "BestCityToLive Intelligence",
    "publisher": "AINT.app",
    "canonical_url": "https://bestcitytolive.com/country/canada"
  },
  "covered_city_count": 4,
  "covered_cities": [
    {
      "id": "city:calgary",
      "slug": "calgary",
      "name": "Calgary",
      "summary": "A prairie city whose river corridors matter as much as its mountain gateway reputation.",
      "reviewed_at": "2026-10-19",
      "canonical_url": "https://bestcitytolive.com/city/calgary",
      "json_url": "https://bestcitytolive.com/api/v1/cities/calgary.json",
      "markdown_url": "https://bestcitytolive.com/api/v1/cities/calgary.md"
    },
    {
      "id": "city:montreal",
      "slug": "montreal",
      "name": "Montreal",
      "summary": "A cultural city where neighbourhood streets, public space and seasonal rhythms carry the story.",
      "reviewed_at": "2026-10-13",
      "canonical_url": "https://bestcitytolive.com/city/montreal",
      "json_url": "https://bestcitytolive.com/api/v1/cities/montreal.json",
      "markdown_url": "https://bestcitytolive.com/api/v1/cities/montreal.md"
    },
    {
      "id": "city:toronto",
      "slug": "toronto",
      "name": "Toronto",
      "summary": "A neighbourhood metropolis best understood beyond its downtown skyline and waterfront postcard.",
      "reviewed_at": "2026-10-13",
      "canonical_url": "https://bestcitytolive.com/city/toronto",
      "json_url": "https://bestcitytolive.com/api/v1/cities/toronto.json",
      "markdown_url": "https://bestcitytolive.com/api/v1/cities/toronto.md"
    },
    {
      "id": "city:vancouver",
      "slug": "vancouver",
      "name": "Vancouver",
      "summary": "Waterfront urban life with a compact centre, distinct neighbourhoods and a much larger regional backdrop.",
      "reviewed_at": "2026-10-13",
      "canonical_url": "https://bestcitytolive.com/city/vancouver",
      "json_url": "https://bestcitytolive.com/api/v1/cities/vancouver.json",
      "markdown_url": "https://bestcitytolive.com/api/v1/cities/vancouver.md"
    }
  ],
  "country_context": [
    {
      "country_code": "CAN",
      "country": "Canada",
      "metric": "SP.DYN.LE00.IN",
      "label": "Life expectancy at birth",
      "value": 82.1080487804878,
      "unit": "years",
      "period": "2024",
      "geography": "country",
      "publisher": "World Bank, World Development Indicators",
      "source_url": "https://data.worldbank.org/indicator/SP.DYN.LE00.IN?locations=CA",
      "api_url": "https://api.worldbank.org/v2/country/CAN;CHE;CHL;CHN;CZE;DEU/indicator/SP.DYN.LE00.IN?format=json&date=2021:2026&per_page=20000",
      "retrieved_at": "2026-10-27",
      "ranking_eligible": false,
      "caveat": "National context; does not measure this city. Latest available year varies by country and indicator.",
      "id": "observation-7ab57f40c75cf20cec23",
      "source_ref": "source-88c6f5a3db011a21",
      "scope": "national-context",
      "evidence_kind": "contextual-observation",
      "provenance": {
        "publisher": "World Bank, World Development Indicators",
        "source_url": "https://data.worldbank.org/indicator/SP.DYN.LE00.IN?locations=CA",
        "api_url": "https://api.worldbank.org/v2/country/CAN;CHE;CHL;CHN;CZE;DEU/indicator/SP.DYN.LE00.IN?format=json&date=2021:2026&per_page=20000",
        "retrieved_at": "2026-10-27",
        "observation_period": "2024",
        "unit": "years",
        "geography": "country"
      }
    },
    {
      "country_code": "CAN",
      "country": "Canada",
      "metric": "IT.NET.USER.ZS",
      "label": "People using the internet",
      "value": 94.353302,
      "unit": "% of population",
      "period": "2024",
      "geography": "country",
      "publisher": "World Bank, World Development Indicators",
      "source_url": "https://data.worldbank.org/indicator/IT.NET.USER.ZS?locations=CA",
      "api_url": "https://api.worldbank.org/v2/country/CAN;CHE;CHL;CHN;CZE;DEU/indicator/IT.NET.USER.ZS?format=json&date=2021:2026&per_page=20000",
      "retrieved_at": "2026-10-27",
      "ranking_eligible": false,
      "caveat": "National context; does not measure this city. Latest available year varies by country and indicator.",
      "id": "observation-1384c3e31df22e35b18e",
      "source_ref": "source-15e3b5e650372940",
      "scope": "national-context",
      "evidence_kind": "contextual-observation",
      "provenance": {
        "publisher": "World Bank, World Development Indicators",
        "source_url": "https://data.worldbank.org/indicator/IT.NET.USER.ZS?locations=CA",
        "api_url": "https://api.worldbank.org/v2/country/CAN;CHE;CHL;CHN;CZE;DEU/indicator/IT.NET.USER.ZS?format=json&date=2021:2026&per_page=20000",
        "retrieved_at": "2026-10-27",
        "observation_period": "2024",
        "unit": "% of population",
        "geography": "country"
      }
    },
    {
      "country_code": "CAN",
      "country": "Canada",
      "metric": "SL.UEM.TOTL.ZS",
      "label": "Unemployment, modelled ILO estimate",
      "value": 6.907,
      "unit": "% of labour force",
      "period": "2025",
      "geography": "country",
      "publisher": "World Bank, World Development Indicators",
      "source_url": "https://data.worldbank.org/indicator/SL.UEM.TOTL.ZS?locations=CA",
      "api_url": "https://api.worldbank.org/v2/country/CAN;CHE;CHL;CHN;CZE;DEU/indicator/SL.UEM.TOTL.ZS?format=json&date=2021:2026&per_page=20000",
      "retrieved_at": "2026-10-27",
      "ranking_eligible": false,
      "caveat": "National context; does not measure this city. Latest available year varies by country and indicator.",
      "id": "observation-3cb90619db853c9f0702",
      "source_ref": "source-2d436b08a557485b",
      "scope": "national-context",
      "evidence_kind": "contextual-observation",
      "provenance": {
        "publisher": "World Bank, World Development Indicators",
        "source_url": "https://data.worldbank.org/indicator/SL.UEM.TOTL.ZS?locations=CA",
        "api_url": "https://api.worldbank.org/v2/country/CAN;CHE;CHL;CHN;CZE;DEU/indicator/SL.UEM.TOTL.ZS?format=json&date=2021:2026&per_page=20000",
        "retrieved_at": "2026-10-27",
        "observation_period": "2025",
        "unit": "% of labour force",
        "geography": "country"
      }
    },
    {
      "country_code": "CAN",
      "country": "Canada",
      "metric": "NY.GDP.PCAP.PP.KD",
      "label": "GDP per capita, PPP",
      "value": 57989.5784653558,
      "unit": "constant 2021 international $",
      "period": "2025",
      "geography": "country",
      "publisher": "World Bank, World Development Indicators",
      "source_url": "https://data.worldbank.org/indicator/NY.GDP.PCAP.PP.KD?locations=CA",
      "api_url": "https://api.worldbank.org/v2/country/CAN;CHE;CHL;CHN;CZE;DEU/indicator/NY.GDP.PCAP.PP.KD?format=json&date=2021:2026&per_page=20000",
      "retrieved_at": "2026-10-27",
      "ranking_eligible": false,
      "caveat": "National context; does not measure this city. Latest available year varies by country and indicator.",
      "id": "observation-cb6540a0488d3c3528a0",
      "source_ref": "source-fd7b845a16c09541",
      "scope": "national-context",
      "evidence_kind": "contextual-observation",
      "provenance": {
        "publisher": "World Bank, World Development Indicators",
        "source_url": "https://data.worldbank.org/indicator/NY.GDP.PCAP.PP.KD?locations=CA",
        "api_url": "https://api.worldbank.org/v2/country/CAN;CHE;CHL;CHN;CZE;DEU/indicator/NY.GDP.PCAP.PP.KD?format=json&date=2021:2026&per_page=20000",
        "retrieved_at": "2026-10-27",
        "observation_period": "2025",
        "unit": "constant 2021 international $",
        "geography": "country"
      }
    }
  ],
  "scope_notice": "Geography is recorded for each observation. National observations are country context, not city estimates. Municipal, census-metropolitan and police-metropolitan records can have different boundaries. A retrieval date is a source check, not the observation period or an editorial review.",
  "ranking_eligible": false,
  "links": {
    "cities": "https://bestcitytolive.com/api/v1/cities.json",
    "sources": "https://bestcitytolive.com/api/v1/sources.json",
    "country_directory": "https://bestcitytolive.com/api/v1/countries.json"
  }
}