Skip to main content

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

    boundary-id string[]required

    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.

    Example: &boundary-id=593979d6da3374b282bb7bbb&boundary-id=593979d6da3374b282bb7bcb (maximum of 20 boundary-ids per request)

Responses​

Schema

    successbooleanrequired

    data

    object[]

    required

  • Array [

    • oneOf

    confidencenumberrequired

    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

    attributionstringrequired

    Attribution to the source of the demographics data.

    sourcestringrequired

    Source country of the demographics data.

    Possible values: [CA, US]

    boundaryIdstringrequired

    The boundary ID for the demographics data.

    populationnumberrequired

    Number of people in the boundary provided.

    populationDensitynumberrequired

    Average number of people in given unit of space for the boundary. Unit defined by populationDensityUnit.

    populationDensityUnitstringrequired

    Unit used to describe populationDensity

    privateHouseholdsnumberrequired

    Number of households in the boundary provided.

    averageHouseholdSizenumberrequired

    Average number of people per household.

    medianAgenumberrequired

    The median age of people in the given boundary.

    medianIncomenumberrequired

    Median household income for the given boundary.

    educationClimateIndexnumbernullablerequired

    A measurement of how students, staff, and parents perceive the quality, character, and health of the learning environments within boundary.

    averageTravelTimenumbernullablerequired

    Average travel time in minutes.

    householdsWithChildrennumberrequired

    Number of households with children in the boundary provided.

    averageRoomsnumberrequired

    Average number of rooms in dwelling.

    medianMortgageMonthlyCostnumberrequired

    Median monthly mortgage payment.

    medianRentMonthlyCostnumberrequired

    Median monthly rent payment.

    medianHouseValuenumberrequired

    Median home value.

    countMarriednumberrequired

    Count of married individuals.

    countUnmarriednumberrequired

    Count of unmarried individuals.

    percentMalenumbernullablerequired

    Percentage of male individuals. From 0 to 100.

    percentFemalenumbernullablerequired

    Percentage of female individuals. From 0 to 100.

    maritalStatus

    object

    required

    marriednumberrequired

    Count of married individuals.

    singlenumberrequired

    Count of single individuals.

    separatednumberrequired

    Count of separated individuals.

    widowednumberrequired

    Count of widowed individuals.

    divorcednumberrequired

    Count of divorced individuals.

    rent

    object

    required

    under499numbernullablerequired

    Count of individuals with monthly rent payments under $499.

    between500To749numberrequired

    Count of individuals with monthly rent payments between $500 and $749.

    between750To999numberrequired

    Count of individuals with monthly rent payments between $750 and $999.

    over999numberrequired

    Count of individuals with monthly rent payments over $999 ($1000 or more).

    occupancy

    object

    required

    vacantnumberrequired

    Count of vacant units.

    unitOccupiedOwnernumberrequired

    Count of units occupied by owners.

    unitOccupiedRenternumberrequired

    Count of units occupied by renters.

    absenteeOwnernumbernullablerequired

    Count of units with absentee owners.

    homeValue

    object

    required

    below100000numbernullablerequired

    Count of homes with value below $100,000.

    between100000To150000numbernullablerequired

    Count of homes with value between $100,000 and $150,000.

    between150000To200000numbernullablerequired

    Count of homes with value between $150,000 and $200,000.

    between200000To300000numbernullablerequired

    Count of homes with value between $200,000 and $300,000.

    between300000To500000numbernullablerequired

    Count of homes with value between $300,000 and $500,000.

    above500000numbernullablerequired

    Count of homes with value above $500,000.

    commuteTime

    object

    required

    under15Minutesnumbernullablerequired

    Commute time under 15 minutes

    between15To29Minutesnumbernullablerequired

    Commute time between 15 to 29 minutes

    between30To59Minutesnumbernullablerequired

    Commute time between 30 to 59 minutes

    over60Minutesnumbernullablerequired

    Commute time over 60 minutes

    enrollment

    object

    required

    publicPrePrimarySchoolnumbernullablerequired

    Count of individuals attending public pre-primary school.

    privatePrePrimarySchoolnumbernullablerequired

    Count of individuals attending private pre-primary school.

    publicCollegenumbernullablerequired

    Count of individuals attending public college.

    privateCollegenumbernullablerequired

    Count of individuals attending private college.

    publicSchoolnumbernullablerequired

    Count of individuals attending public school.

    privateSchoolnumbernullablerequired

    Count of individuals attending private school.

    nonenumbernullablerequired

    Count of individuals not attending any educational institution.

    education

    object

    required

    noDegreenumberrequired

    Count of individuals with no degree.

    highSchoolnumberrequired

    Count of individuals with a high school degree.

    collegeBelowBachelornumberrequired

    Count of individuals with some college education but no bachelor's degree.

    bachelornumberrequired

    Count of individuals with a bachelor's degree.

    masternumberrequired

    Count of individuals with a master's degree.

    doctoratenumberrequired

    Count of individuals with a doctorate degree.

    medianMortgagePayment

    object

    required

    under500numbernullablerequired

    Count of individuals with a mortgage payment under $500.

    between500To1000numbernullablerequired

    Count of individuals with a mortgage payment between $500 and $1000.

    between1000To2000numbernullablerequired

    Count of individuals with a mortgage payment between $1000 and $2000.

    between2000To3000numbernullablerequired

    Count of individuals with a mortgage payment between $2000 and $3000.

    between3000To4000numbernullablerequired

    Count of individuals with a mortgage payment between $3000 and $4000.

    over4000numbernullablerequired

    Count of individuals with a mortgage payment over $4000.

    rooms

    object

    required

    studionumberrequired

    Count of studio units.

    oneBedroomnumberrequired

    Count of one-bedroom units.

    twoBedroomsnumberrequired

    Count of two-bedroom units.

    threeBedroomsnumberrequired

    Count of three-bedroom units.

    fourBedroomsOrMorenumberrequired

    Count of four-bedroom or more units.

    transportationMode

    object

    required

    bicyclenumberrequired

    Number of people that commute by bike.

    carAlonenumberrequired

    Number people that drive alone.

    carCarpoolnumberrequired

    Number of people that carpool.

    carDrivernumberrequired

    Number of people that are drivers.

    carSelfnumbernullablerequired

    Number of people that drive themselves.

    othernumberrequired

    Number of people that use other means of transportation for commute.

    publicTransitnumberrequired

    Number of people that commute by public transit.

    walkednumberrequired

    Number of people that walk.

    occupation

    object

    required

    agriculturenumberrequired

    Number of people in the agriculture occupation.

    appliedSciencenumberrequired

    Number of people in the applied science occupation.

    artCultureSportnumberrequired

    Number of people in the art, culture, and sport occupation.

    businessFinanceAdminnumberrequired

    Number of people in the business, finance, and administration occupation.

    educationLawSocialGovernmentnumberrequired

    Number of people in the education, law, social, and government services occupation.

    managementnumberrequired

    Number of people in the management occupation.

    manufacturingnumberrequired

    Number of people in the manufacturing occupation.

    notApplicablenumberrequired

    Number of people where occupation is not applicable.

    salesnumberrequired

    Number of people in the sales occupation.

    tradesnumberrequired

    Number of people in the trades occupation.

    jobSector

    object

    required

    governmentWorkernumberrequired

    Count of government workers.

    notForProfitWorkernumberrequired

    Count of not-for-profit workers.

    privateWorkernumbernullablerequired

    Count of private workers.

    selfEmployedWorkernumbernullablerequired

    Count of self-employed workers.

    unpaidFamilyWorkernumbernullablerequired

    Count of unpaid family workers.

    jobType

    object

    required

    blueCollarnumberrequired

    Count of individuals in blue-collar jobs.

    whiteCollarnumberrequired

    Count of individuals in white-collar jobs.

    annualResidentialTurnovernumber

    Number of households that change occupiers per year in the boundary provided.

    yearBuilt

    object

    required

    before1970numberrequired

    Count of units built before 1970.

    between1970To1979numberrequired

    Count of units built between 1970 and 1979.

    between1980To1989numberrequired

    Count of units built between 1980 and 1989.

    between1990To1999numberrequired

    Count of units built between 1990 and 1999.

    between2000To2009numberrequired

    Count of units built between 2000 and 2009.

    between2010To2019numberrequired

    Count of units built between 2010 and 2019.

    after2019numberrequired

    Count of units built after 2019.

    income

    object

    required

    byLevel

    object

    required

    between0To25000numberrequired

    Number of people with income between $0 and $25,000

    between25000To35000numberrequired

    Number of people with income between $25,000 and $35,000

    between35000To50000numberrequired

    Number of people with income between $35,000 and $50,000

    between50000To75000numberrequired

    Number of people with income between $50,000 and $75,000

    between75000To100000numberrequired

    Number of people with income between $75,000 and $100,000

    over100000numberrequired

    Number of people with income over $100,000

    byCohort

    object

    required

    between0To10knumberrequired

    Number of people with income between $0 and $10,000

    between10kTo15knumberrequired

    Number of people with income between $10,000 and $15,000

    between15kTo20knumberrequired

    Number of people with income between $15,000 and $20,000

    between20kTo25knumberrequired

    Number of people with income between $20,000 and $25,000

    between25kTo30knumberrequired

    Number of people with income between $25,000 and $30,000

    between30kTo35knumberrequired

    Number of people with income between $30,000 and $35,000

    between35kTo40knumberrequired

    Number of people with income between $35,000 and $40,000

    between40kTo45knumberrequired

    Number of people with income between $40,000 and $45,000

    between45kTo50knumberrequired

    Number of people with income between $45,000 and $50,000

    between50kTo60knumberrequired

    Number of people with income between $50,000 and $60,000

    between60kTo75knumberrequired

    Number of people with income between $60,000 and $75,000

    between75kTo100knumberrequired

    Number of people with income between $60,000 and $75,000

    between100kTo125knumberrequired

    Number of people with income between $100,000 and $125,000

    between125kTo15knumberrequired

    Number of people with income between $125,000 and $150,000

    between150kTo200knumberrequired

    Number of people with income between $150,000 and $200,000

    over200knumberrequired

    Number of people with income over $200,000

    age

    object

    required

    byLifeStage

    object

    required

    between0To9numberrequired

    Count of individuals between 0 to 9 years old.

    between10To17numberrequired

    Count of individuals between 10 to 17 years old.

    between18To24numberrequired

    Count of individuals between 18 to 24 years old.

    between25To64numberrequired

    Count of individuals between 25 to 64 years old.

    between65To74numberrequired

    Count of individuals between 65 to 74 years old.

    between75AndOvernumberrequired

    Count of individuals 75 years old and over.

    byCohort

    object

    required

    between0To4numberrequired

    Count of individuals between 0 to 4 years old.

    between5To9numberrequired

    Count of individuals between 5 to 9 years old.

    between10To14numberrequired

    Count of individuals between 10 to 14 years old.

    between15To19numberrequired

    Count of individuals between 15 to 19 years old.

    between25To29numberrequired

    Count of individuals between 25 to 29 years old.

    between30To34numberrequired

    Count of individuals between 30 to 34 years old.

    between35To39numberrequired

    Count of individuals between 35 to 39 years old.

    between40To44numberrequired

    Count of individuals between 40 to 44 years old.

    between45To49numberrequired

    Count of individuals between 45 to 49 years old.

    between50To54numberrequired

    Count of individuals between 50 to 54 years old.

    between55To59numberrequired

    Count of individuals between 55 to 59 years old.

    between60To64numberrequired

    Count of individuals between 60 to 64 years old.

    between65To69numberrequired

    Count of individuals between 65 to 69 years old.

    between70To74numberrequired

    Count of individuals between 70 to 74 years old.

    between75To79numberrequired

    Count of individuals between 75 to 79 years old.

    between80To84numberrequired

    Count of individuals between 80 to 84 years old.

    between85AndOvernumberrequired

    Count of individuals 85 years old and over.

  • ]