Deprivation Indices

England
Wales
Scotland
gethttps://crystalroof.co.uk/customer-api/deprivation/indices/postcode/v1/{location}

Description

This method provides statistics on relative deprivation in England, Wales, and Scotland, including:

  • The Index of Multiple Deprivation (IMD) – a measure of overall deprivation
  • Domain-specific indices (e.g., income, employment, education, health etc.) that differ by country
  • Area rankings and deciles for simplified analysis

Area Types

The indices assess deprivation at a small-area level:

  • England & Wales: Lower-layer Super Output Areas (LSOAs)
  • Scotland: Data Zones

Ranking & Deciles

Each area is ranked from most to least deprived:

  • England: 1 (most deprived) to 32,844 (least deprived)
  • Wales: 1 (most deprived) to 1,909 (least deprived)
  • Scotland: 1 (most deprived) to 6,976 (least deprived)

The ranks are available in the imdRank field, with domain-specific ranks in fields such as incomeRank, employmentRank, crimeRank, etc.

To simplify, areas are also categorized into deciles (1 = most deprived, 10 = least deprived), available in fields like imdDecile, incomeDecile, employmentDecile, etc.

Mapping & Consumer Platform Adjustments

We use deciles to color-code our deprivation map. However, on our consumer platform, we reversed the ratings scale to match user expectations where higher ratings are associated with higher deprivation.

For example, postcode W6 0LJ (imdDecile 2, a highly deprived area) is displayed as “Index of Multiple Deprivation - 9/10 or high” on the consumer platform.

Data Availability

  • England & Wales: 2019
  • Scotland: 2020

Pricing

1 credit per 1 request.

Parameters

NameDescription
location
path
string
Postcode, coordinates in the lat,long format or UPRN in the uprn12345678 format.
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/deprivation/indices/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