Occupancy rating for rooms

England
Wales
gethttps://crystalroof.co.uk/customer-api/housing/occupancy-rating-for-rooms/postcode/v1/{location}

Description

This method returns Census 2021 estimates that classify households by occupancy rating based on the number of rooms in the household.

Occupancy rating for rooms defines whether a household's accommodation is overcrowded, ideally occupied or under-occupied. This is calculated by comparing the number of rooms the household requires to the number of available rooms.

The number of rooms the household requires uses a formula which states that:

  • one-person households require three rooms comprised of two common rooms and one bedroom
  • two-or-more person households require a minimum of two common rooms and a bedroom for each person inline with the Bedroom Standard

People who should have their own room according to the Bedroom Standard are:

  • married or cohabiting couple
  • single parent
  • person aged 16 years and over
  • pair of same-sex persons aged 10 to 15 years
  • person aged 10 to 15 years paired with a person under 10 years of the same sex
  • pair of children aged under 10 years, regardless of their sex
  • person aged under 16 years who cannot share a bedroom with someone in 4, 5 or 6 above

An occupancy rating of:

  • -1 or less: implies that a household's accommodation has fewer rooms than required (overcrowded)
  • +1 or more: implies that a household's accommodation has more rooms than required (under-occupied)
  • 0: suggests that a household's accommodation has an ideal number of rooms

The number of rooms is taken from Valuation Office Agency (VOA) administrative data for the first time in 2021. The number of rooms is recorded at the address level. This means that for households that live in a shared dwelling, the available number of rooms are counted for the whole dwelling in VOA, and not each individual household.

VOA's definition of a room does not include bathrooms, toilets, halls or landings, kitchens, conservatories or utility rooms. All other rooms, for example, living rooms, studies, bedrooms, separate dining rooms and rooms that can only be used for storage are included.

“Occupancy rating for rooms” is split into 6 categories including total.

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

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 40-25 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/housing/occupancy-rating-for-rooms/postcode/v1/{location}?api_key=DEMO
Possible responses with examples
Code
Description
200
Success
401
Unauthorized
402
Payment Required
403
Forbidden
429
Too Many Requests
500
Internal Server Error