2016 Census Profile Web Data Service (WDS) - User Guide

Returns all 2016 Census Profile data for a geography of interest.

Resource URL

https://www12.statcan.gc.ca/rest/census-recensement/CPR2016{.type}?lang={lang}&dguid={dguid}&topic={topic}&notes={notes}

Resource information

Response formats
JSON, XML
Requires authentication
No
GET
Yes
POST
No

Parameters

Five parameters can be added to the main URL. These parameters are for format type, language, geography, topic and footnotes.

Name Required Value and notes
type Yes

json|xml

where:

  • json = json response format
  • xml = xml response format
lang No

E|F (default = E)

where:

  • E = English
  • F = French
dguid No

one dguid (default=2016A000011124)

To find dguid, use any dguid returned by the 2016 Census geography web data service:

https://www12.statcan.gc.ca/rest/censusapp/CensusGeoService.json?lang={lang}&geolevel={geolevel}¬es={notes}

Where geolevels are:

  • CD = Census divisions
  • CMACA = Census metropolitan areas and census agglomerations
  • CSD = Census subdivisions (municipalities)
  • CT = Census tracts
  • DPL = Designated places
  • ER = Economic regions
  • FED = Federal electoral districts (2013 Representation Order)
  • FSA = Forward sortation areas
  • HR = Health regions (including LHINs and PHUs)
  • POPCNTR = Population centres
  • PR = Canada, provinces and territories

Geographic area note: Global non-response rates and data quality flags associated with a geography are provided by the 2016 Census geography data service.

topic No

Integer 0-14 (default=0)

where:

  • 0 = All topics
  • 1 = Aboriginal peoples
  • 2 = Education
  • 3 = Ethnic origin
  • 4 = Families, households and marital status
  • 5 = Housing
  • 6 = Immigration and citizenship
  • 7 = Income
  • 8 = Journey to work
  • 9 = Labour
  • 10 = Language
  • 11 = Language of work
  • 12 = Mobility
  • 13 = Population
  • 14 = Visible minority
notes No

0|1 (default = 0)

where:

  • 0 = do not include footnotes
  • 1 = include footnotes

Resource parameters

PROV_TERR_ID
The province or territory geocode i.e., 35 = Ontario
PROV_TERR_NAME_NOM
Name of the province or territory
GEO_UID
The geographic identifier which include geography boundary vintage, level and code
GEO_ID
The geographic code for the geography
GEO_NAME_NOM
The geographic name
GEO_TYPE
The geographic area type, if applicable, i.e., C = City. Otherwise, null.
TOPIC_THEME
Topic name
TEXT_ID
Text identifier
HIER_ID
Returns a numbering sequence to identify topic, grouping, parent, child relationship of the TEXT_NAME_NOM field. The first digit identifies topic, the second digit identifies grouping, the third and subsequent digits identify the relationship between TEXT_NAME_NOM fields within a topic/grouping.
INDENT_ID
Returns the number of indentations for the TEXT_NAME_NOM field.
TEXT_NAME_NOM
Text for the data line
NOTE_ID
Footnote number, if applicable. Otherwise, null.
NOTE
Footnote text that would accompany the text for the data line, if applicable. Otherwise, null.
T_DATA_DONNEE
Data point value for total
T_SYM
Symbol that would accompany or replace the total data point value
M_DATA_DONNEE
Data point value for male
M_SYM
Symbol that would accompany or replace the male data point value
F_DATA_DONNEE
Data point value for female
F_SYM
Symbol that would accompany or replace the female data point value

Note: For T_SYM, M_SYM and F_SYM

..
not available for a specific reference period
...
not applicable
E
use with caution
F
too unreliable to be published
r
revised
x
suppressed to meet the confidentiality requirements of the Statistics Act

Sourcing / Citation

Source: Statistics Canada, 2016 Census of Population.

How to cite: Statistics Canada. 2017. Census Profile. 2016 Census. Statistics Canada Catalogue no. 98-316-X2016001. Ottawa. Released November 29, 2017.
https://www12.statcan.gc.ca/census-recensement/2016/dp-pd/prof/index.cfm?Lang=E

Example request

GET

https://www12.statcan.gc.ca/rest/census-recensement/CPR2016.json?lang=E&dguid=2016A000011124&topic=1&notes=0

Example result

//{
  "COLUMNS": [
    "PROV_TERR_ID",
    "PROV_TERR_NAME_NOM",
    "GEO_UID",
    "GEO_ID",
    "GEO_NAME_NOM",
    "GEO_TYPE",
    "TOPIC_THEME",
    "TEXT_ID",
    "HIER_ID",
    "INDENT_ID",
    "TEXT_NAME_NOM",
    "NOTE_ID",
    "NOTE",
    "T_DATA_DONNEE",
    "T_SYM",
    "M_DATA_DONNEE",
    "M_SYM",
    "F_DATA_DONNEE",
    "F_SYM"
  ],
  "DATA": [
    [
      "01",
      "Canada",
      "2016A000011124",
      "01",
      "Canada",
      null,
      "Population",
      1000,
      1.1.1,
      0,
      "Population, 2016",
      1,
      null,
      35151728,
      null,
      null,
      "...",
      null,
      "..."
    ],
    [
      "01",
      "Canada",
      "2016A000011124",
      "01",
      "Canada",
      null,
      "Population",
      1001,
      1.1.2,
      0,
      "Population, 2011",
      1,
      null,
      33476688,
      null,
      null,
      "...",
      null,
      "..."
    ],
    [
      "01",
      "Canada",
      "2016A000011124",
      "01",
      "Canada",
      null,
      "Population",
      1002,
      1.1.3,
      0,
      "Population percentage change, 2011 to 2016",
      null,
      null,
      5,
      null,
      null,
      "...",
      null,
      "..."
    ],
    [
      "01",
      "Canada",
      "2016A000011124",
      "01",
      "Canada",
      null,
      "Population",
      1003,
      1.1.4,
      0,
      "Total private dwellings",
      2,
      null,
      15412443,
      null,
      null,
      "...",
      null,
      "..."
    ],
    [
      "01",
      "Canada",
      "2016A000011124",
      "01",
      "Canada",
      null,
      "Population",
      1004,
      1.1.5,
      0,
      "Private dwellings occupied by usual residents",
      3,
      null,
      14072079,
      null,
      null,
      "...",
      null,
      "..."
    ],
    [
      "01",
      "Canada",
      "2016A000011124",
      "01",
      "Canada",
      null,
      "Population",
      1005,
      1.1.6,
      0,
      "Population density per square kilometre",
      null,
      null,
      3.9,
      null,
      null,
      "...",
      null,
      "..."
    ],
    [
      "01",
      "Canada",
      "2016A000011124",
      "01",
      "Canada",
      null,
      "Population",
      1006,
      1.1.7,
      0,
      "Land area in square kilometres",
      null,
      null,
      8965588.85,
      null,
      null,
      "...",
      null,
      "..."
    ] 
  ]
}
    
Date modified: