Statistics Canada
App · 11 actions
Read Canada's official statistics from Statistics Canada: the Consumer Price Index, jobs and unemployment, GDP, population, housing, trade and thousands more tables. Search the tables, see what a table holds, pick a series by name, get its latest figures or those between two dates, and see what was released on a day. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Find a series in a table | Find one series in a table by its member names (such as 'Canada; All-items') or coordinate, and get its vector number, title, unit and frequency, ready for the steps that read series by vector. |
| Get data released between two dates | Get the figures of one or more series that Statistics Canada released or revised between two days, whatever period they are about: what changed since the last time a workflow looked. |
| Get latest data for series | Get the most recent figures of one or more series by vector number, such as the latest Consumer Price Index or unemployment rate, each with its period, release time and any revision or quality note. |
| Get latest data from a table | Get the most recent figures of one or more series in a table, picked by member names (such as 'Ontario; Unemployment rate; ...') or coordinates, without looking up their vector numbers first. |
| Get series data between two dates | Get the figures of one or more series for the reference periods between two dates, such as every month of 2025, oldest first. |
| Get series details | Get the details of one or more series by vector number: title, table, coordinate, unit, scale, frequency and whether it is still updated. |
| Get table details | Get a Statistics Canada table's details: title, how often it is updated, the period it covers, when it was last released, its dimensions (such as Geography) with their member counts, footnotes, corrections and links to download the whole table. |
| List dimension members | List the members of one dimension of a table, such as every province in Geography or every product in the CPI, with the IDs and names that pick out a series. |
| List series updated today | List the series Statistics Canada updated today, optionally only those in one table, each with its vector, title, unit and table. |
| List tables released on a day | List the tables Statistics Canada released or updated on a day, today by default, each with its title, frequency and link. |
| Search tables | Find Statistics Canada data tables by words in their titles, narrowed by subject, survey and how often they are updated. |
Find a series in a table
Find one series in a table by its member names (such as 'Canada; All-items') or coordinate, and get its vector number, title, unit and frequency, ready for the steps that read series by vector.
Inputs
- Table
tabletextRequired - The table: pick a headline table, or type its table number (such as 18-10-0004-01), its 8-digit product ID (18100004) or paste its link. 'Search tables' finds the rest.
- Series
seriestextRequired - The series: its member names in the table's dimension order, separated by semicolons (such as 'Canada; All-items'), or its coordinate, the member IDs separated by dots (such as 2.2). 'Get table details' lists the dimensions and 'List dimension members' their members.
Outputs
coordinatetext- Where the series sits in its table: one member ID for each dimension, in order, such as '2.2'.
decimalsnumber- How many decimal places the figures are given to.
frequencytext- How often the series gets a new figure, such as 'Monthly'.
product_idnumber- The table's 8-digit product ID, such as 18100004. Every field that takes a table accepts it.
scaletext- What to multiply the numbers by, such as 'units' (as they are) or 'thousands'.
table_numbertext- The table number as Statistics Canada's site writes it, such as 18-10-0004-01.
table_titletext- The title of the table the series belongs to.
terminatedtrue/false- True when the series is no longer updated.
titletext- The series' members, one per dimension, such as 'Canada; All-items'.
unittext- What the numbers measure, such as 'Percent' or '2002=100'.
urltext- The table's page on Statistics Canada's site.
vectortext- The series' vector, such as 'v41690973': its own number, which every series field takes.
vector_idnumber- The vector as a plain number, such as 41690973.
Example output
{
"coordinate": "1.7.1.1.1.1",
"decimals": 1,
"frequency": "Monthly",
"product_id": 14100287,
"scale": "units",
"table_number": "14-10-0287-01",
"table_title": "Labour force characteristics, monthly, seasonally adjusted and trend-cycle",
"terminated": false,
"title": "Canada; Unemployment rate; Total - Gender; 15 years and over; Estimate; Seasonally adjusted",
"unit": "Percent",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1410028701",
"vector": "v2062815",
"vector_id": 2062815
}Get data released between two dates
Get the figures of one or more series that Statistics Canada released or revised between two days, whatever period they are about: what changed since the last time a workflow looked.
Inputs
- Series
vectorstextRequired - The series: pick a headline series, or type vector numbers such as v41690973, several separated by commas (up to 50). A table's page shows each series' vector, and 'Find a series in a table' gives one.
- Released from
released_fromdateRequired - The first release day to include, in Eastern time.
- Released to
released_todate - The last release day to include, in Eastern time. Leave empty for today.
Outputs
countnumber- How many series were found.
not_foundlist- The series asked for that Statistics Canada doesn't have, as given.
point_countnumber- How many figures were returned across every series.
released_fromtext- The first release day read, in Eastern time.
released_totext- The last release day read, in Eastern time: today when none was given.
serieslist- Each series found, in the order asked, with its figures.
Example output
{
"count": 1,
"not_found": [],
"point_count": 1,
"released_from": "2026-10-19",
"released_to": "2026-10-19",
"series": [
{
"coordinate": "2.2",
"count": 1,
"data": [
{
"period": "September 2026",
"reference_period": "2026-09-01",
"reference_period_end": null,
"released_at": "2026-10-19T12:30:00Z",
"revision": null,
"status": null,
"suppressed": false,
"value": 170.0
}
],
"decimals": 1,
"frequency": "Monthly",
"latest_period": "September 2026",
"latest_reference_period": "2026-09-01",
"latest_value": 170.0,
"product_id": 18100004,
"scale": "units",
"table_number": "18-10-0004-01",
"table_title": "Consumer Price Index, monthly, not seasonally adjusted",
"terminated": false,
"title": "Canada; All-items",
"unit": "2002=100",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1810000401",
"vector": "v41690973",
"vector_id": 41690973
}
]
}Get latest data for series
Get the most recent figures of one or more series by vector number, such as the latest Consumer Price Index or unemployment rate, each with its period, release time and any revision or quality note.
Inputs
- Series
vectorstextRequired - The series: pick a headline series, or type vector numbers such as v41690973, several separated by commas (up to 50). A table's page shows each series' vector, and 'Find a series in a table' gives one.
- Periods
periodsnumber - How many of the most recent reference periods to return for each series (months, for a monthly series), from 1 to 500.From 1 to 500. Default:
1.
Outputs
countnumber- How many series were found.
not_foundlist- The series asked for that Statistics Canada doesn't have, as given.
point_countnumber- How many figures were returned across every series.
serieslist- Each series found, in the order asked, with its figures.
Example output
{
"count": 1,
"not_found": [],
"point_count": 2,
"series": [
{
"coordinate": "2.2",
"count": 2,
"data": [
{
"period": "August 2026",
"reference_period": "2026-08-01",
"reference_period_end": null,
"released_at": "2026-09-14T12:30:00Z",
"revision": null,
"status": null,
"suppressed": false,
"value": 169.8
},
{
"period": "September 2026",
"reference_period": "2026-09-01",
"reference_period_end": null,
"released_at": "2026-10-19T12:30:00Z",
"revision": null,
"status": null,
"suppressed": false,
"value": 170.0
}
],
"decimals": 1,
"frequency": "Monthly",
"latest_period": "September 2026",
"latest_reference_period": "2026-09-01",
"latest_value": 170.0,
"product_id": 18100004,
"scale": "units",
"table_number": "18-10-0004-01",
"table_title": "Consumer Price Index, monthly, not seasonally adjusted",
"terminated": false,
"title": "Canada; All-items",
"unit": "2002=100",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1810000401",
"vector": "v41690973",
"vector_id": 41690973
}
]
}Get latest data from a table
Get the most recent figures of one or more series in a table, picked by member names (such as 'Ontario; Unemployment rate; ...') or coordinates, without looking up their vector numbers first.
Inputs
- Table
tabletextRequired - The table: pick a headline table, or type its table number (such as 18-10-0004-01), its 8-digit product ID (18100004) or paste its link. 'Search tables' finds the rest.
- Series
seriestextRequired - The series, one per line (up to 50). Give each as its member names in the table's dimension order, separated by semicolons (such as 'Canada; All-items'), or its coordinate, the member IDs separated by dots (such as 2.2). 'Get table details' lists the dimensions and 'List dimension members' their members.
- Periods
periodsnumber - How many of the most recent reference periods to return for each series (months, for a monthly series), from 1 to 500.From 1 to 500. Default:
1.
Outputs
countnumber- How many series were found.
not_foundlist- The series asked for that Statistics Canada doesn't have, as given.
point_countnumber- How many figures were returned across every series.
serieslist- Each series found, in the order asked, with its figures.
Example output
{
"count": 1,
"not_found": [],
"point_count": 2,
"series": [
{
"coordinate": "1.7.1.1.1.1",
"count": 2,
"data": [
{
"period": "August 2026",
"reference_period": "2026-08-01",
"reference_period_end": null,
"released_at": "2026-10-09T12:30:00Z",
"revision": null,
"status": null,
"suppressed": false,
"value": 6.4
},
{
"period": "September 2026",
"reference_period": "2026-09-01",
"reference_period_end": null,
"released_at": "2026-10-09T12:30:00Z",
"revision": null,
"status": null,
"suppressed": false,
"value": 6.5
}
],
"decimals": 1,
"frequency": "Monthly",
"latest_period": "September 2026",
"latest_reference_period": "2026-09-01",
"latest_value": 6.5,
"product_id": 14100287,
"scale": "units",
"table_number": "14-10-0287-01",
"table_title": "Labour force characteristics, monthly, seasonally adjusted and trend-cycle",
"terminated": false,
"title": "Canada; Unemployment rate; Total - Gender; 15 years and over; Estimate; Seasonally adjusted",
"unit": "Percent",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1410028701",
"vector": "v2062815",
"vector_id": 2062815
}
]
}Get series data between two dates
Get the figures of one or more series for the reference periods between two dates, such as every month of 2025, oldest first.
Inputs
- Series
vectorstextRequired - The series: pick a headline series, or type vector numbers such as v41690973, several separated by commas (up to 50). A table's page shows each series' vector, and 'Find a series in a table' gives one.
- From
start_datedateRequired - Figures for reference periods on or after this date. A monthly figure is dated the first day of its month, so pick 2025-01-01 to include January 2025.
- To
end_datedate - Figures for reference periods on or before this date. Leave empty for everything up to the latest.
Outputs
countnumber- How many series were found.
end_datetext- The last reference date read (YYYY-MM-DD): today when none was given.
not_foundlist- The series asked for that Statistics Canada doesn't have, as given.
point_countnumber- How many figures were returned across every series.
serieslist- Each series found, in the order asked, with its figures.
start_datetext- The first reference date read (YYYY-MM-DD).
Example output
{
"count": 1,
"end_date": "2025-03-01",
"not_found": [],
"point_count": 3,
"series": [
{
"coordinate": "2.2",
"count": 3,
"data": [
{
"period": "January 2025",
"reference_period": "2025-01-01",
"reference_period_end": null,
"released_at": "2025-02-18T13:30:00Z",
"revision": null,
"status": null,
"suppressed": false,
"value": 161.3
},
{
"period": "February 2025",
"reference_period": "2025-02-01",
"reference_period_end": null,
"released_at": "2025-03-18T12:30:00Z",
"revision": null,
"status": null,
"suppressed": false,
"value": 163.0
},
{
"period": "March 2025",
"reference_period": "2025-03-01",
"reference_period_end": null,
"released_at": "2025-04-15T12:30:00Z",
"revision": null,
"status": null,
"suppressed": false,
"value": 163.5
}
],
"decimals": 1,
"frequency": "Monthly",
"latest_period": "March 2025",
"latest_reference_period": "2025-03-01",
"latest_value": 163.5,
"product_id": 18100004,
"scale": "units",
"table_number": "18-10-0004-01",
"table_title": "Consumer Price Index, monthly, not seasonally adjusted",
"terminated": false,
"title": "Canada; All-items",
"unit": "2002=100",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1810000401",
"vector": "v41690973",
"vector_id": 41690973
}
],
"start_date": "2025-01-01"
}Get series details
Get the details of one or more series by vector number: title, table, coordinate, unit, scale, frequency and whether it is still updated.
Inputs
- Series
vectorstextRequired - The series: pick a headline series, or type vector numbers such as v41690973, several separated by commas (up to 50). A table's page shows each series' vector, and 'Find a series in a table' gives one.
Outputs
countnumber- How many series were found.
not_foundlist- The vectors asked for that don't exist.
serieslist- Each series found, in the order asked.
Example output
{
"count": 2,
"not_found": [],
"series": [
{
"coordinate": "2.2",
"decimals": 1,
"frequency": "Monthly",
"product_id": 18100004,
"scale": "units",
"table_number": "18-10-0004-01",
"table_title": "Consumer Price Index, monthly, not seasonally adjusted",
"terminated": false,
"title": "Canada; All-items",
"unit": "2002=100",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1810000401",
"vector": "v41690973",
"vector_id": 41690973
},
{
"coordinate": "1.7.1.1.1.1",
"decimals": 1,
"frequency": "Monthly",
"product_id": 14100287,
"scale": "units",
"table_number": "14-10-0287-01",
"table_title": "Labour force characteristics, monthly, seasonally adjusted and trend-cycle",
"terminated": false,
"title": "Canada; Unemployment rate; Total - Gender; 15 years and over; Estimate; Seasonally adjusted",
"unit": "Percent",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1410028701",
"vector": "v2062815",
"vector_id": 2062815
}
]
}Get table details
Get a Statistics Canada table's details: title, how often it is updated, the period it covers, when it was last released, its dimensions (such as Geography) with their member counts, footnotes, corrections and links to download the whole table.
Inputs
- Table
tabletextRequired - The table: pick a headline table, or type its table number (such as 18-10-0004-01), its 8-digit product ID (18100004) or paste its link. 'Search tables' finds the rest.
Outputs
archivedtrue/false- True when the table is archived and no longer updated.
cansim_idtext- Its number in CANSIM, the old database, such as 326-0020.
correctionslist- Corrections Statistics Canada has made to the table's figures.
csv_download_urltext- A link to download the whole table as CSV, in a zip file.
data_point_countnumber- How many figures the table holds.
dimension_countnumber- How many dimensions the table has.
dimensionslist- The table's dimensions in order: a series picks one member of each.
end_datetext- The latest reference period it covers (YYYY-MM-DD).
footnoteslist- The table's footnotes, each once.
frequencytext- How often the table's figures come out.
product_idnumber- The table's 8-digit product ID, such as 18100004. Every field that takes a table accepts it.
released_attext- When it was last released, in UTC, as an ISO 8601 date and time (8:30 a.m. Eastern is 12:30 or 13:30 UTC).
sdmx_download_urltext- A link to download the whole table as SDMX, in a zip file.
series_countnumber- How many series the table holds.
start_datetext- The first reference period it covers (YYYY-MM-DD).
subjectslist- The subjects it is filed under.
surveyslist- The surveys or programs its figures come from.
table_numbertext- The table number as Statistics Canada's site writes it, such as 18-10-0004-01.
titletext- The table's title.
urltext- The table's page on Statistics Canada's site.
Example output
{
"archived": false,
"cansim_id": "326-0022",
"corrections": [],
"csv_download_url": "https://www150.statcan.gc.ca/n1/tbl/csv/18100006-eng.zip",
"data_point_count": 4587,
"dimension_count": 2,
"dimensions": [
{
"has_units": false,
"member_count": 1,
"name": "Geography",
"position": 1
},
{
"has_units": true,
"member_count": 11,
"name": "Products and product groups",
"position": 2
}
],
"end_date": "2026-09-01",
"footnotes": [
{
"applies_to": [
"The whole table"
],
"id": 1,
"text": "The Consumer Price Index (CPI) is an indicator of the changes in consumer prices experienced by the target population."
},
{
"applies_to": [
"The whole table"
],
"id": 2,
"text": "The Consumer Price Index (CPI) is not a cost-of-living index."
}
],
"frequency": "Monthly",
"product_id": 18100006,
"released_at": "2026-10-19T12:30:00Z",
"sdmx_download_url": "https://www150.statcan.gc.ca/n1/tbl/sdmx/18100006-SDMX.zip",
"series_count": 11,
"start_date": "1992-01-01",
"subjects": [
"Prices and price indexes > Consumer price indexes"
],
"surveys": [
"Consumer Price Index"
],
"table_number": "18-10-0006-01",
"title": "Consumer Price Index, monthly, seasonally adjusted",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1810000601"
}List dimension members
List the members of one dimension of a table, such as every province in Geography or every product in the CPI, with the IDs and names that pick out a series. Narrow by words in the name.
Inputs
- Table
tabletextRequired - The table: pick a headline table, or type its table number (such as 18-10-0004-01), its 8-digit product ID (18100004) or paste its link. 'Search tables' finds the rest.
- Dimension
dimensiontextRequired - The dimension, such as Geography: pick one once the table is chosen, or type its name or position (1 for the first).
- Name contains
querytext - Only members whose names contain these words, such as 'Ontario' or 'gasoline'. Leave empty for every member.
- How many to return
limitnumber - How many members to return, up to 1,000.From 1 to 1000. Default:
100.
Outputs
countnumber- How many members are returned.
dimension_countnumber- How many dimensions the table has.
dimension_nametext- The dimension's name.
dimension_positionnumber- The dimension's place in a coordinate, from 1.
matchingnumber- How many members matched the name filter.
memberslist- The members, in the table's order.
product_idnumber- The table's 8-digit product ID, such as 18100004. Every field that takes a table accepts it.
table_numbertext- The table number as Statistics Canada's site writes it, such as 18-10-0004-01.
table_titletext- The table's title.
totalnumber- How many members the dimension has.
Example output
{
"count": 3,
"dimension_count": 2,
"dimension_name": "Products and product groups",
"dimension_position": 2,
"matching": 11,
"members": [
{
"classification_code": null,
"member_id": 1,
"name": "All-items",
"parent_id": null,
"parent_name": null,
"terminated": false,
"unit": "2002=100"
},
{
"classification_code": null,
"member_id": 2,
"name": "Food",
"parent_id": 1,
"parent_name": "All-items",
"terminated": false,
"unit": "2002=100"
},
{
"classification_code": null,
"member_id": 3,
"name": "Shelter",
"parent_id": 1,
"parent_name": "All-items",
"terminated": false,
"unit": "2002=100"
}
],
"product_id": 18100006,
"table_number": "18-10-0006-01",
"table_title": "Consumer Price Index, monthly, seasonally adjusted",
"total": 11
}List series updated today
List the series Statistics Canada updated today, optionally only those in one table, each with its vector, title, unit and table. The list fills at 8:30 a.m. Eastern on release days.
Inputs
- Table
tabletext - Only series in this table: pick a headline table, or type a table number such as 33-10-0036-01. Leave empty for every series updated today.
- How many to return
limitnumber - How many series to return, up to 300.From 1 to 300. Default:
100.
Outputs
countnumber- How many series are returned.
datetext- Today's date in Eastern time (YYYY-MM-DD).
matchingnumber- How many of them are in the table asked for.
serieslist- The series updated today.
totalnumber- How many series were updated today.
Example output
{
"count": 2,
"date": "2026-10-23",
"matching": 27,
"series": [
{
"coordinate": "1.25",
"decimals": 4,
"frequency": "Daily",
"product_id": 33100036,
"released_at": "2026-10-23T12:30:00Z",
"scale": "units",
"table_number": "33-10-0036-01",
"table_title": "Daily average foreign exchange rates in Canadian dollars, Bank of Canada",
"terminated": false,
"title": "Canada; U.S. dollar, daily average",
"unit": "Dollars",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=3310003601",
"vector": "v111666248",
"vector_id": 111666248
},
{
"coordinate": "1.1",
"decimals": 4,
"frequency": "Daily",
"product_id": 33100036,
"released_at": "2026-10-23T12:30:00Z",
"scale": "units",
"table_number": "33-10-0036-01",
"table_title": "Daily average foreign exchange rates in Canadian dollars, Bank of Canada",
"terminated": false,
"title": "Canada; Australian dollar, daily average",
"unit": "Dollars",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=3310003601",
"vector": "v111666224",
"vector_id": 111666224
}
],
"total": 1764
}List tables released on a day
List the tables Statistics Canada released or updated on a day, today by default, each with its title, frequency and link. Releases come out at 8:30 a.m. Eastern on business days.
Inputs
- Release date
release_datedate - The day to list, in Eastern time. Leave empty for today. A weekend or holiday usually lists none.
Outputs
countnumber- How many tables were updated that day.
datetext- The release day listed (YYYY-MM-DD, Eastern time).
tableslist- The tables updated that day.
Example output
{
"count": 2,
"date": "2026-10-22",
"tables": [
{
"archived": false,
"end_date": "2026-09-01",
"frequency": "Monthly",
"product_id": 10100003,
"released_at": "2026-10-22T12:30:00Z",
"start_date": "1975-01-01",
"subjects": [
"Government"
],
"surveys": [
"Bank of Canada"
],
"table_number": "10-10-0003-01",
"title": "Government of Canada debt securities: Gross new issues, retirements and net new issues, par value, Bank of Canada",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1010000301"
},
{
"archived": false,
"end_date": "2026-09-01",
"frequency": "Monthly",
"product_id": 10100130,
"released_at": "2026-10-22T12:30:00Z",
"start_date": "1975-01-01",
"subjects": [
"Government"
],
"surveys": [
"Bank of Canada"
],
"table_number": "10-10-0130-01",
"title": "Government of Canada bonds outstanding, shown at par value, by currency of payments",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1010013001"
}
]
}Search tables
Find Statistics Canada data tables by words in their titles, narrowed by subject, survey and how often they are updated. Each comes with its table number, the period it covers, when it was last released and its link.
Inputs
- Search text
querytext - Words to look for in table titles (English or French), such as 'consumer price index' or 'housing starts'. A table number finds that table. Leave empty to browse with the other fields.
- Subject
subjecttext - Only tables filed under this subject, such as Labour or Housing. Leave empty for every subject.
- Survey
surveytext - Only tables from this survey or program, such as the Labour Force Survey. Pick one or type its name or code. Leave empty for all.
- Frequency
frequencytext - Only tables updated this often, such as Monthly. Leave empty for any.
- Include archived tables
include_archivedtrue/false - Also return archived tables, which are kept for reference but no longer updated.Default:
false. - Sort by
sorttext - The order of the results. Best match by default.One of:
relevance(Best match),newest(Most recently released),table_number(Table number). Default:relevance. - How many to return
limitnumber - How many tables to return, up to 100.From 1 to 100. Default:
20.
Outputs
countnumber- How many tables are returned.
tableslist- The tables found, best first.
totalnumber- How many tables matched.
Example output
{
"count": 2,
"tables": [
{
"archived": false,
"end_date": "2026-09-01",
"frequency": "Monthly",
"product_id": 18100006,
"released_at": "2026-10-19T12:30:00Z",
"start_date": "1992-01-01",
"subjects": [
"Prices and price indexes"
],
"surveys": [
"Consumer Price Index"
],
"table_number": "18-10-0006-01",
"title": "Consumer Price Index, monthly, seasonally adjusted",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1810000601"
},
{
"archived": false,
"end_date": "2026-09-01",
"frequency": "Monthly",
"product_id": 18100004,
"released_at": "2026-10-19T12:30:00Z",
"start_date": "1914-01-01",
"subjects": [
"Prices and price indexes"
],
"surveys": [
"Consumer Price Index"
],
"table_number": "18-10-0004-01",
"title": "Consumer Price Index, monthly, not seasonally adjusted",
"url": "https://www150.statcan.gc.ca/t1/tbl1/en/tv.action?pid=1810000401"
}
],
"total": 8
}