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

Release date: September 13, 2018Updated on: November 13, 2019

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}&stat={stat}

Resource information

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

Parameters

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

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)

Dissemination Geography Unique Identifier - DGUID

It is an alphanumeric code, composed of four components. It varies from 10 to 21 characters in length. The first 9 characters are fixed in composition and length.

Vintage (4) + Type (1) + Schema (4) + Geographic Unique Identifier (1-12).

To find dguid, use any GEO_UID (i.e., DGUID) returned by the 2016 Census geography web data service.

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

For more information on the DGUID definition and structure, please refer to the Dissemination Geography Unique Identifier: Definition and Structure, Statistics Canada catalogue no. 92F0138M-2019001.

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
stat No

0|1 (default = 0)

where:

  • 0 = counts
  • 1 = rates

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 (i.e., DGUID) which include geography boundary vintage, level and code. For more information, please refer to Dissemination Geography Unique Identifier: Definition and Structure.
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

Source and 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&stat=0

Note: The returning result is proceeded with two forward slashes (i.e., //) which should be bypassed when using the results.

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,
      "..."
    ] 
  ]
}
    
Report a problem on this page

Is something not working? Is there information outdated? Can't find what you're looking for?

Please contact us and let us know how we can help you.

Privacy notice

Date modified: