For Individuals

CrystalRoofCrystalRoof

Household composition

England
Wales
gethttps://crystalroof.co.uk/customer-api/demographics-and-migration/household-composition/postcode/v1/{location}

Description

This method returns Census 2021 estimates that classify households by the relationships between household members.

One-family households are classified by: - the number of dependent children, - family type (married, civil partnership or cohabiting couple family, or lone parent family).

Other households are classified by: - the number of people - the number of dependent children - whether the household consists only of students or only of people aged 66 and over.

The estimates are as at Census Day, 21 March 2021.

Pricing

1 credit per 1 request.

Parameters

NameDescription
location
path
string
Postcode, coordinates in the lat,long format or UPRN in the uprn12345678 format.
area_type
query
enum

Area types used in Census 2021. The method returns results based on the inclusion of the postcode/coordinate/UPRN within the designated geographical area. For instance, when using 'oa' as a parameter, the returned results will be for the Output Area that contains the specified postcode/coordinate/UPRN.

  • oa - Output area (OA), the smallest geographical area used in the census, comprises 25-40 households and a population of 100-625 persons.
  • lsoa - Lower layer Super Output Area (LSOA), a small geographical area used in the census, comprises 400-1200 households and a population of 1000-3000 persons. Lower layer Super Output Areas (LSOAs) are made up of groups of OAs, usually four or five.
  • msoa - Middle layer Super Output Area (MSOA), a small geographical area used in the census, comprises 2,000-6,000 households and a population of 5,000 and 15,000 persons. MSOAs are made up of groups of LSOAs, usually four or five. MSOAs fit within local authorities.
  • lad - Local Authority District. There are a total of 296 districts in England made up of 36 metropolitan boroughs, 32 London boroughs, 164 two-tier non-metropolitan districts and 62 unitary authorities, City of London district and Isles of Scilly district. In Wales, there are 22 local authorities, which are named principal areas..
  • region - nine regions of England (London, the North East, North West, Yorkshire, East Midlands, West Midlands, South East, East of England and the South West) and Wales as a whole.
  • country - constituent countries of the UK: England, Scotland, Wales and Northern Ireland.
api_key
query
enum

Your API key.

DEMO key allows you to test the method in the W6 0 postcode sector, or in the [[51.492, -0.25], [51.502, -0.225]] rectangle.

Request URL:
https://crystalroof.co.uk/customer-api/demographics-and-migration/household-composition/postcode/v1/{location}?api_key=DEMO
Possible responses with examples
Code
Description
200
Success
401
Unauthorized
402
Payment Required
403
Forbidden
404
Not Found
429
Too Many Requests
500
Internal Server Error