Canada Home Costs logo chc CANADA HOME COSTS

Schema

Property tax

Scenario-based municipal or provincial property tax components by year.

Required fields

  • submission_type
  • jurisdiction_key
  • effective_date
  • sources
  • payload.tax_year
  • payload.scenario.scenario_key
  • payload.scenario.scenario_label
  • payload.scenario.coverage
  • payload.components
  • payload.components.*.component_key
  • payload.components.*.component_label
  • payload.components.*.authority_type
  • payload.components.*.published_rate_value
  • payload.components.*.published_rate_basis

When a rate basis is percent, use decimals (0.01 = 1%).

Example payload

{
  "tax_year": 2025,
  "property_class": "residential",
  "scenario": {
    "scenario_key": "urban_ft_fire",
    "scenario_label": "Urban (Full-Time Fire)",
    "coverage": "complete_total",
    "requires_zone_selector": false,
    "zone_selector_label": null,
    "zone_selector_options": null
  },
  "components": [
    {
      "component_key": "municipal_general",
      "component_label": "Municipal",
      "authority_type": "municipal",
      "published_rate_value": 0.0105,
      "published_rate_basis": "per_dollar"
    },
    {
      "component_key": "education",
      "component_label": "Education",
      "authority_type": "provincial_education",
      "published_rate_value": 0.003225297,
      "published_rate_basis": "per_dollar"
    }
  ]
}

Raw schema

{PUBLIC_API_BASE_URL}/api/v1/intake/schemas/property_tax

Last updated: February 9, 2026