Proficiency in English

England
Wales
gethttps://crystalroof.co.uk/customer-api/ethnicity-language-and-religion/proficiency-in-english/postcode/v1/{location}

Description

This method returns Census 2021 estimates that classify usual residents aged 3 years and over by their proficiency in English.

Proficiency in English language is how well people whose main language is not English (English or Welsh in Wales) speak English.

Proficiency in English language is split into 7 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.
Postcode with or without space. This argument is case-insensitive.
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/ethnicity-language-and-religion/proficiency-in-english/postcode/v1/W60WW?api_key=DEMO
Possible responses with examples
Code
Description
200
Success
{
  "data": {
    "residents": {
      "Total": 189,
      "Main language is English (English or Welsh in Wales)": 155,
      "Main language is not English (English or Welsh in Wales)": 34,
      "Main language is not English (English or Welsh in Wales): Can speak English very well": 13,
      "Main language is not English (English or Welsh in Wales): Can speak English well": 14,
      "Main language is not English (English or Welsh in Wales): Cannot speak English well": 5,
      "Main language is not English (English or Welsh in Wales): Cannot speak English": 2
    },
    "rank": {
      "Main language is English (English or Welsh in Wales)": 6,
      "Main language is not English (English or Welsh in Wales)": 5,
      "Main language is not English (English or Welsh in Wales): Can speak English very well": 4,
      "Main language is not English (English or Welsh in Wales): Can speak English well": 5,
      "Main language is not English (English or Welsh in Wales): Cannot speak English well": 4,
      "Main language is not English (English or Welsh in Wales): Cannot speak English": 4
    }
  },
  "dataDate": "2021-03-21",
  "refreshedDate": "2021-03-21"
} 
401
Unauthorized
{
  "error": "No such API key or it is not valid anymore."
} 
402
Payment Required
{
  "error": "You have exhausted the available calls provided by your package."
} 
403
Forbidden
{
  "error": "API key is invalid for the given action."
} 
429
Too Many Requests
{
  "error": "Too many requests have been sent in one second."
} 
500
Internal Server Error
{
  "error": "We have already started working on a resolution!"
} 
Cookies
This site uses cookies for purposes including analytics, personalization and advertising. By continuing to browse this website you agree to this use. For more information see our Privacy Policy