Demographics
GET/v4/demographics
The /v4/demographics endpoint returns survey data from a country's census. Currently the only countries supported are the United States of America and Canada.
The API uses an ID of a boundary to locate census data for the boundary.
Because of the nature of generating census data for neighborhoods, some data will be less accurate than others. To determine how accurate data is, the confidence value between 0-100 is included for each boundary.
Request
Query Parameters
The boundary ID(s) to get demographics information on. Demographics information will only be returned if the boundary exists and there is demographics information available for it. Only 20 boundary IDs can be supplied per request.
Responses
- 200
- 401
- 403
- 429
- 500
- 504
- application/json
- Schema
- Example (from schema)
Schema
Array [
- DemographicsForUnitedStates
- DemographicsForCanada
]
data
object[]
required
oneOf
Score of LiveBy's confidence in the accuracy of the statistics produced. This is a percentage from 0 to 100, with 100 being the highest confidence.
metadata
object
required
Attribution to the source of the demographics data.
Possible values: [CA, US]
Source country of the demographics data.
The boundary ID for the demographics data.
Number of people in the boundary provided.
Average number of people in given unit of space for the boundary. Unit defined by populationDensityUnit.
Unit used to describe populationDensity
Number of households in the boundary provided.
Average number of people per household.
The median age of people in the given boundary.
Median household income for the given boundary.
A measurement of how students, staff, and parents perceive the quality, character, and health of the learning environments within boundary.
Average travel time in minutes.
Number of households with children in the boundary provided.
Average number of rooms in dwelling.
Median monthly mortgage payment.
Median monthly rent payment.
Median home value.
Count of married individuals.
Count of unmarried individuals.
Percentage of male individuals. From 0 to 100.
Percentage of female individuals. From 0 to 100.
maritalStatus
object
required
Count of married individuals.
Count of single individuals.
Count of separated individuals.
Count of widowed individuals.
Count of divorced individuals.
rent
object
required
Count of individuals with monthly rent payments under $499.
Count of individuals with monthly rent payments between $500 and $749.
Count of individuals with monthly rent payments between $750 and $999.
Count of individuals with monthly rent payments over $999 ($1000 or more).
occupancy
object
required
Count of vacant units.
Count of units occupied by owners.
Count of units occupied by renters.
Count of units with absentee owners.
homeValue
object
required
Count of homes with value below $100,000.
Count of homes with value between $100,000 and $150,000.
Count of homes with value between $150,000 and $200,000.
Count of homes with value between $200,000 and $300,000.
Count of homes with value between $300,000 and $500,000.
Count of homes with value above $500,000.
commuteTime
object
required
Commute time under 15 minutes
Commute time between 15 to 29 minutes
Commute time between 30 to 59 minutes
Commute time over 60 minutes
enrollment
object
required
Count of individuals attending public pre-primary school.
Count of individuals attending private pre-primary school.
Count of individuals attending public college.
Count of individuals attending private college.
Count of individuals attending public school.
Count of individuals attending private school.
Count of individuals not attending any educational institution.
education
object
required
Count of individuals with no degree.
Count of individuals with a high school degree.
Count of individuals with some college education but no bachelor's degree.
Count of individuals with a bachelor's degree.
Count of individuals with a master's degree.
Count of individuals with a doctorate degree.
medianMortgagePayment
object
required
Count of individuals with a mortgage payment under $500.
Count of individuals with a mortgage payment between $500 and $1000.
Count of individuals with a mortgage payment between $1000 and $2000.
Count of individuals with a mortgage payment between $2000 and $3000.
Count of individuals with a mortgage payment between $3000 and $4000.
Count of individuals with a mortgage payment over $4000.
rooms
object
required
Count of studio units.
Count of one-bedroom units.
Count of two-bedroom units.
Count of three-bedroom units.
Count of four-bedroom or more units.
transportationMode
object
required
Number of people that commute by bike.
Number people that drive alone.
Number of people that carpool.
Number of people that are drivers.
Number of people that drive themselves.
Number of people that use other means of transportation for commute.
Number of people that commute by public transit.
Number of people that walk.
occupation
object
required
Number of people in the agriculture occupation.
Number of people in the applied science occupation.
Number of people in the art, culture, and sport occupation.
Number of people in the business, finance, and administration occupation.
Number of people in the education, law, social, and government services occupation.
Number of people in the management occupation.
Number of people in the manufacturing occupation.
Number of people where occupation is not applicable.
Number of people in the sales occupation.
Number of people in the trades occupation.
jobSector
object
required
Count of government workers.
Count of not-for-profit workers.
Count of private workers.
Count of self-employed workers.
Count of unpaid family workers.
jobType
object
required
Count of individuals in blue-collar jobs.
Count of individuals in white-collar jobs.
Number of households that change occupiers per year in the boundary provided.
yearBuilt
object
required
Count of units built before 1970.
Count of units built between 1970 and 1979.
Count of units built between 1980 and 1989.
Count of units built between 1990 and 1999.
Count of units built between 2000 and 2009.
Count of units built between 2010 and 2019.
Count of units built after 2019.
income
object
required
byLevel
object
required
Number of people with income between $0 and $25,000
Number of people with income between $25,000 and $35,000
Number of people with income between $35,000 and $50,000
Number of people with income between $50,000 and $75,000
Number of people with income between $75,000 and $100,000
Number of people with income over $100,000
byCohort
object
required
Number of people with income between $0 and $10,000
Number of people with income between $10,000 and $15,000
Number of people with income between $15,000 and $20,000
Number of people with income between $20,000 and $25,000
Number of people with income between $25,000 and $30,000
Number of people with income between $30,000 and $35,000
Number of people with income between $35,000 and $40,000
Number of people with income between $40,000 and $45,000
Number of people with income between $45,000 and $50,000
Number of people with income between $50,000 and $60,000
Number of people with income between $60,000 and $75,000
Number of people with income between $60,000 and $75,000
Number of people with income between $100,000 and $125,000
Number of people with income between $125,000 and $150,000
Number of people with income between $150,000 and $200,000
Number of people with income over $200,000
age
object
required
byLifeStage
object
required
Count of individuals between 0 to 9 years old.
Count of individuals between 10 to 17 years old.
Count of individuals between 18 to 24 years old.
Count of individuals between 25 to 64 years old.
Count of individuals between 65 to 74 years old.
Count of individuals 75 years old and over.
byCohort
object
required
Count of individuals between 0 to 4 years old.
Count of individuals between 5 to 9 years old.
Count of individuals between 10 to 14 years old.
Count of individuals between 15 to 19 years old.
Count of individuals between 25 to 29 years old.
Count of individuals between 30 to 34 years old.
Count of individuals between 35 to 39 years old.
Count of individuals between 40 to 44 years old.
Count of individuals between 45 to 49 years old.
Count of individuals between 50 to 54 years old.
Count of individuals between 55 to 59 years old.
Count of individuals between 60 to 64 years old.
Count of individuals between 65 to 69 years old.
Count of individuals between 70 to 74 years old.
Count of individuals between 75 to 79 years old.
Count of individuals between 80 to 84 years old.
Count of individuals 85 years old and over.
Score of LiveBy's confidence in the accuracy of the statistics produced. This is a percentage from 0 to 100, with 100 being the highest confidence.
metadata
object
required
Attribution to the source of the demographics data.
Possible values: [CA, US]
Source country of the demographics data.
The boundary ID for the demographics data.
Number of people in the boundary provided.
Average number of people in given unit of space for the boundary. Unit defined by populationDensityUnit.
Unit used to describe populationDensity
Number of households in the boundary provided.
Average number of people per household.
The median age of people in the given boundary.
Median household income for the given boundary.
A measurement of how students, staff, and parents perceive the quality, character, and health of the learning environments within boundary.
Average travel time in minutes.
Number of households with children in the boundary provided.
Average number of rooms in dwelling.
Median monthly mortgage payment.
Median monthly rent payment.
Median home value.
Count of married individuals.
Count of unmarried individuals.
Percentage of male individuals. From 0 to 100.
Percentage of female individuals. From 0 to 100.
maritalStatus
object
required
Count of married individuals.
Count of single individuals.
Count of separated individuals.
Count of widowed individuals.
Count of divorced individuals.
rent
object
required
Count of individuals with monthly rent payments under $499.
Count of individuals with monthly rent payments between $500 and $749.
Count of individuals with monthly rent payments between $750 and $999.
Count of individuals with monthly rent payments over $999 ($1000 or more).
occupancy
object
required
Count of vacant units.
Count of units occupied by owners.
Count of units occupied by renters.
Count of units with absentee owners.
homeValue
object
required
Count of homes with value below $100,000.
Count of homes with value between $100,000 and $150,000.
Count of homes with value between $150,000 and $200,000.
Count of homes with value between $200,000 and $300,000.
Count of homes with value between $300,000 and $500,000.
Count of homes with value above $500,000.
commuteTime
object
required
Commute time under 15 minutes
Commute time between 15 to 29 minutes
Commute time between 30 to 59 minutes
Commute time over 60 minutes
enrollment
object
required
Count of individuals attending public pre-primary school.
Count of individuals attending private pre-primary school.
Count of individuals attending public college.
Count of individuals attending private college.
Count of individuals attending public school.
Count of individuals attending private school.
Count of individuals not attending any educational institution.
education
object
required
Count of individuals with no degree.
Count of individuals with a high school degree.
Count of individuals with some college education but no bachelor's degree.
Count of individuals with a bachelor's degree.
Count of individuals with a master's degree.
Count of individuals with a doctorate degree.
medianMortgagePayment
object
required
Count of individuals with a mortgage payment under $500.
Count of individuals with a mortgage payment between $500 and $1000.
Count of individuals with a mortgage payment between $1000 and $2000.
Count of individuals with a mortgage payment between $2000 and $3000.
Count of individuals with a mortgage payment between $3000 and $4000.
Count of individuals with a mortgage payment over $4000.
rooms
object
required
Count of studio units.
Count of one-bedroom units.
Count of two-bedroom units.
Count of three-bedroom units.
Count of four-bedroom or more units.
transportationMode
object
required
Number of people that commute by bike.
Number people that drive alone.
Number of people that carpool.
Number of people that are drivers.
Number of people that drive themselves.
Number of people that use other means of transportation for commute.
Number of people that commute by public transit.
Number of people that walk.
occupation
object
required
Number of people in the agriculture occupation.
Number of people in the applied science occupation.
Number of people in the art, culture, and sport occupation.
Number of people in the business, finance, and administration occupation.
Number of people in the education, law, social, and government services occupation.
Number of people in the management occupation.
Number of people in the manufacturing occupation.
Number of people where occupation is not applicable.
Number of people in the sales occupation.
Number of people in the trades occupation.
jobSector
object
required
Count of government workers.
Count of not-for-profit workers.
Count of private workers.
Count of self-employed workers.
Count of unpaid family workers.
jobType
object
required
Count of individuals in blue-collar jobs.
Count of individuals in white-collar jobs.
Average income per household for the given boundary.
yearBuilt
object
required
Number of units built before 1961.
Number of units built between 1961 and 1980.
Number of units built between 1981 and 1990.
Number of units built between 1991 and 2000.
Number of units built between 2001 and 2005.
Number of units built between 2006 and 2010.
Number of units built between 2011 and 2015.
Number of units built between 2016 and 2021.
income
object
required
byLevel
object
required
Number of people with income between $0 and $25,000
Number of people with income between $25,000 and $35,000
Number of people with income between $35,000 and $50,000
Number of people with income between $50,000 and $75,000
Number of people with income between $75,000 and $100,000
Number of people with income over $100,000
byCohort
object
required
Number of people with income between $0 and $10,000
Number of people with income between $10,000 and $15,000
Number of people with income between $15,000 and $20,000
Number of people with income between $20,000 and $25,000
Number of people with income between $25,000 and $30,000
Number of people with income between $30,000 and $35,000
Number of people with income between $35,000 and $40,000
Number of people with income between $40,000 and $45,000
Number of people with income between $45,000 and $50,000
Number of people with income between $50,000 and $60,000
Number of people with income between $60,000 and $70,000
Number of people with income between $70,000 and $100,000
Number of people with income between $100,000 and $125,000
Number of people with income between $125,000 and $150,000
Number of people with income between $150,000 and $200,000
Number of people with income over $200,000
structureType
object
required
Count of apartment units.
Count of detached house units.
Count of duplex apartment units.
Count of high-rise units.
Count of mobile units.
Count of other units.
Count of semi-detached house units.
Count of townhouse units.
Total count of all units.
age
object
required
byLifeStage
object
required
Count of individuals between 0 to 9 years old.
Count of individuals between 10 to 19 years old.
Count of individuals between 20 to 24 years old.
Count of individuals between 25 to 64 years old.
Count of individuals between 65 to 74 years old.
Count of individuals 75 years old and over.
byCohort
object
required
Count of individuals between 0 to 4 years old.
Count of individuals between 5 to 9 years old.
Count of individuals between 10 to 14 years old.
Count of individuals between 15 to 19 years old.
Count of individuals between 25 to 29 years old.
Count of individuals between 30 to 34 years old.
Count of individuals between 35 to 39 years old.
Count of individuals between 40 to 44 years old.
Count of individuals between 45 to 49 years old.
Count of individuals between 50 to 54 years old.
Count of individuals between 55 to 59 years old.
Count of individuals between 60 to 64 years old.
Count of individuals between 65 to 69 years old.
Count of individuals between 70 to 74 years old.
Count of individuals between 75 to 79 years old.
Count of individuals between 80 to 84 years old.
Count of individuals 85 years old and over.
Total count of individuals.
{
"success": true,
"data": [
{},
{}
]
}
Unauthorized
Forbidden
Too Many Requests
Internal Server Error
Service Unavailable