Canada — T1FF Income API

What you can build

Original T1 Family File tables 11-10-0008, 11-10-0014 and 11-10-0051: individual medians/distributions, census-family income sources, before/after-tax income and taxes. Preserve tax reference years, native DGUID/vintage, family/sex/age universes, units, scalar factors and suppression. The 2024 release is delayed during T1FF+ redesign. Income thresholds overlap; medians, families and persons are not additive. Use this dataset as a sourced input to an application, analytical model or retrieval tool. Retain its native dimensions when joining it with your own records.

Query Canada — T1FF Income

The example below is a real bounded request against the available release. Replace the environment variable with your server-side API credential. Review endpoint parameters and response schemas before changing selectors.

curl --fail --get "https://api.geoamcan.com/v1/canada/economy?dataset=ca-t1ff-income&product_id=11100008&geo=Canada&period_start=2023&period_end=2023&dimension_filters=%7B%22Sex%22%3A+%22Both+sexes%22%2C+%22Age+group%22%3A+%22All+age+groups%22%2C+%22Persons+with+income%22%3A+%22Median+total+income%22%7D&limit=1" \
  -H "Authorization: Bearer $GEOAMCAN_API_KEY"

Saved response excerpt

{
  "requested_area": {
    "dataset": "ca-t1ff-income",
    "product_id": "11100008",
    "dguid": null,
    "geo": "Canada",
    "geo_q": null,
    "vector": null,
    "coordinate": null,
    "source_row": null,
    "period_start": "2023",
    "period_end": "2023",
    "dimension_filters": "{\"Sex\": \"Both sexes\", \"Age group\": \"All age groups\", \"Persons with income\": \"Median total income\"}",
    "frequency": "all"
  },
  "data": [
    {
      "product_id": "11100008",
      "series_id": "374f3e5b801aa7abdce0f3f6e4c70e2df55c993cfcc65342b332156713293a04",
      "source_row": 929973,
      "period": "2023",
      "dguid": "2021A000011124",
      "geo_name": "Canada",
      "vector": "v20790267",
      "coordinate": "1.1.1.15",
      "dimensions": {
        "Sex": "Both sexes",
        "Age group": "All age groups",
        "Persons with income": "Median total income"
      },
      "uom": "Dollars",
      "scalar_factor": "units",
      "value": 45000
    }
  ],
  "availability": {
    "status": "available",
    "coverage": [
      {
        "title": "Tax filers and dependants with income by total income, sex and age",
        "series": 62211,
        "records": 985200,
        "product_id": "11100008",
        "last_period": "2023",
        "unavailable": 79115,
        "first_period": "2000",
        "native_dguids": 195,
        "source_release": "2025-07-18T08:30",
        "reported_zeroes": 6496,
        "geography_labels": 195,
        "reference_window": "annual"
      }
    ],
    "ordering": "product ID ascending, native reference period descending, source row ascending"
  },
  "snapshot": {
    "ca-t1ff-income": {
      "release_id": 121,
      "release": "T1FF income through 2023; published table editions",
      "fingerprint": "7aa1a4e3c0e4ec2274f1ae94b394d094"
    }
  },
  "returned_count": 1,
  "complete": true,
  "next_offset": null,
  "limitations": [
    "Statistics Canada T1 Family File administrative tax-filer/dependant and census-family income tables; selected published Canada/province/CMA/CA areas, not complete small-area or postal coverage. Persons, families, income amounts, medians and overlapping income thresholds are separate units; do not sum overlapping categories or average medians. Source dollars/scalar factors, annual tax reference periods, age/sex/family dimensions, geographic vintages, rounding and suppression remain explicit. These are not a complete resident population census, personal tax returns or U.S.-dollar incomes. Latest published reference year is 2023; the agency delayed 2024 during T1FF+ redesign. Historical boundaries and program changes can break comparisons."
  ],
  "source_attribution": {
    "ca-t1ff-income": "Statistics Canada; reproduced and distributed under the Statistics Canada Open Licence. https://www.statcan.gc.ca/en/terms-conditions/open-licence"
  },
  "metric_definitions": {
    "value": {
      "meaning": "Source numeric value in published UOM and SCALAR_FACTOR; unavailable/confidential values remain null"
    },
    "value_exact": {
      "meaning": "Original VALUE text, preserved even when suppressed"
    },
    "value_in_base_units": {
      "meaning": "Value multiplied only by the explicitly recognized source scalar label; original UOM retained. No currency conversion or inflation adjustment."
    },
    "status": {
      "meaning": "Native reliability/suppression code; see source product metadata. E means use caution, F is too unreliable, x is confidential."
    },
    "period": {
      "meaning": "Native annual year or monthly reference period. Consult product title for monthly versus three-month moving average; annual totals and monthly data are separate."
    },
    "dimensions": {
      "meaning": "Exact source labels; age, gender/sex, family, income, adjustment and statistic universes must match before comparison."
    }
  },
  "country": "CA"
}

Captured 2026-11-05. Excerpt omits pagination credentials and may shorten nested records. Download verified source responses.

Coverage and interpretation

Statistics Canada T1 Family File administrative tax-filer/dependant and census-family income tables; selected published Canada/province/CMA/CA areas, not complete small-area or postal coverage. Persons, families, income amounts, medians and overlapping income thresholds are separate units; do not sum overlapping categories or average medians. Source dollars/scalar factors, annual tax reference periods, age/sex/family dimensions, geographic vintages, rounding and suppression remain explicit. These are not a complete resident population census, personal tax returns or U.S.-dollar incomes. Latest published reference year is 2023; the agency delayed 2024 during T1FF+ redesign. Historical boundaries and program changes can break comparisons. Source dimensions, original table metadata, reliability/suppression codes and scalar factors are retained. Geography is joined only to an identical installed native DGUID; unmatched historical vintages are not reassigned to current polygons.

The active release shown here is a catalog snapshot. Check the live catalog and response provenance for current readiness. The underlying public source and Geoamcan access terms are separate; consult the source’s licensing and attribution requirements.

Source and methodology

Source: Statistics Canada. Geoamcan is an independent API provider, with no agency affiliation or endorsement. Read our data methodology for source handling, geographic joins and update practices.

Related data

• Canada — Census Geographic Boundaries
• Canada — Census Population and Dwellings
• Canada — Census Profile
• Canada — Reported Postal Areas and Population