Main language (detailed)

England

Wales

gethttps://crystalroof.co.uk/customer-api/ethnicity-language-and-religion/main-language-detailed/postcode/v1/{location}

Description

This method returns Census 2021 estimates that classify usual residents aged 3 years and over by their main language.

Main language is a person's first or preferred language.

Main language is split into 106 categories including total.

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

Parameters

Name	Description
location path string	Postcode, coordinates in the lat,long format or UPRN in the uprn12345678 format. Examples Postcode with or without space. This argument is case-insensitive. Value
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. 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. Value
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. Value

Request URL:

https://crystalroof.co.uk/customer-api/ethnicity-language-and-religion/main-language-detailed/postcode/v1/W60WW?api_key=DEMO

Possible responses with examples

Code

Description

200

Success

{
  "data": {
    "residents": {
      "Total": 177635,
      "English (English or Welsh in Wales)": 139670,
      "Welsh or Cymraeg (in England only)": 48,
      "Other UK language": 17,
      "Other UK language: Gaelic (Irish)": 3,
      "Other UK language: Gaelic (Scottish)": 3,
      "Other UK language: Manx Gaelic": 0,
      "Other UK language: Gaelic (Not otherwise specified)": 1,
      "Other UK language: Cornish": 0,
      "Other UK language: Scots": 3,
      "Other UK language: Ulster Scots": 0,
      "Other UK language: Romany English": 7,
      "Other UK language: Irish Traveller Cant": 0,
      "French": 4462,
      "Portuguese": 2375,
      "Spanish": 4389,
      "Other European language (EU)": 10628,
      "Other European language (EU): Italian": 4003,
      "Other European language (EU): German": 779,
      "Other European language (EU): Polish": 1558,
      "Other European language (EU): Slovak": 110,
      "Other European language (EU): Czech": 125,
      "Other European language (EU): Romanian": 719,
      "Other European language (EU): Lithuanian": 307,
      "Other European language (EU): Latvian": 64,
      "Other European language (EU): Hungarian": 421,
      "Other European language (EU): Bulgarian": 412,
      "Other European language (EU): Greek": 1081,
      "Other European language (EU): Dutch": 280,
      "Other European language (EU): Swedish": 360,
      "Other European language (EU): Danish": 121,
      "Other European language (EU): Finnish": 76,
      "Other European language (EU): Estonian": 47,
      "Other European language (EU): Slovenian": 38,
      "Other European language (EU): Maltese": 5,
      "Other European language (EU): Any other European language (EU)": 122,
      "Other European language (non EU)": 883,
      "Other European language (non EU): Albanian": 623,
      "Other European language (non EU): Ukrainian": 142,
      "Other European language (non EU): Any other Eastern European language (non EU)": 9,
      "Other European language (non EU): Northern European language (non EU)": 109,
      "Other European language (EU and non-EU)": 448,
      "Other European language (EU and non-EU): Bosnian, Croatian, Serbian, and Montenegrin": 448,
      "Other European language (non-national)": 2,
      "Other European language (non-national): Any Romani language": 2,
      "Other European language (non-national): Yiddish": 0,
      "Russian": 976,
      "Turkish": 655,
      "Arabic": 2809,
      "West or Central Asian language": 1841,
      "West or Central Asian language: Hebrew": 51,
      "West or Central Asian language: Kurdish": 286,
      "West or Central Asian language: Persian or Farsi": 1121,
      "West or Central Asian language: Pashto": 184,
      "West or Central Asian language: Any other West or Central Asian language": 199,
      "South Asian language": 1312,
      "South Asian language: Urdu": 335,
      "South Asian language: Hindi": 92,
      "South Asian language: Panjabi": 81,
      "South Asian language: Pakistani Pahari (with Mirpuri and Potwari)": 1,
      "South Asian language: Bengali (with Sylheti and Chatgaya)": 380,
      "South Asian language: Gujarati": 143,
      "South Asian language: Marathi": 17,
      "South Asian language: Telugu": 9,
      "South Asian language: Tamil": 73,
      "South Asian language: Malayalam": 66,
      "South Asian language: Sinhala": 34,
      "South Asian language: Nepalese": 36,
      "South Asian language: Any other South Asian language": 45,
      "East Asian language": 4372,
      "East Asian language: Mandarin Chinese": 309,
      "East Asian language: Cantonese Chinese": 311,
      "East Asian language: All other Chinese": 1211,
      "East Asian language: Japanese": 374,
      "East Asian language: Korean": 148,
      "East Asian language: Vietnamese": 77,
      "East Asian language: Thai": 252,
      "East Asian language: Malay": 88,
      "East Asian language: Tagalog or Filipino": 1428,
      "East Asian language: Any other East Asian language": 174,
      "Oceanic or Australian language": 0,
      "North or South American language": 1,
      "Caribbean Creole": 3,
      "Caribbean Creole: English-based Caribbean Creole": 0,
      "Caribbean Creole: Any other Caribbean Creole": 3,
      "African language": 2640,
      "African language: Amharic": 509,
      "African language: Tigrinya": 456,
      "African language: Somali": 1327,
      "African language: Krio": 8,
      "African language: Akan": 49,
      "African language: Yoruba": 39,
      "African language: Igbo": 29,
      "African language: Swahili or Kiswahili": 31,
      "African language: Luganda": 12,
      "African language: Lingala": 26,
      "African language: Shona": 5,
      "African language: Afrikaans": 26,
      "African language: Any other Nigerian language": 6,
      "African language: Any other West African language": 36,
      "African language: Any other African language": 81,
      "Sign language": 67,
      "Sign language: British Sign Language": 51,
      "Sign language: Any other sign language": 7,
      "Sign language: Any sign communication system": 9,
      "Other language": 37
    },
    "rank": {
      "English (English or Welsh in Wales)": 3,
      "Welsh or Cymraeg (in England only)": 7,
      "Other UK language": 5,
      "Other UK language: Gaelic (Irish)": 5,
      "Other UK language: Gaelic (Scottish)": 9,
      "Other UK language: Manx Gaelic": 1,
      "Other UK language: Gaelic (Not otherwise specified)": 0,
      "Other UK language: Cornish": 1,
      "Other UK language: Scots": 5,
      "Other UK language: Ulster Scots": 1,
      "Other UK language: Romany English": 4,
      "Other UK language: Irish Traveller Cant": 1,
      "French": 9,
      "Portuguese": 8,
      "Spanish": 8,
      "Other European language (EU)": 7,
      "Other European language (EU): Italian": 10,
      "Other European language (EU): German": 7,
      "Other European language (EU): Polish": 3,
      "Other European language (EU): Slovak": 3,
      "Other European language (EU): Czech": 5,
      "Other European language (EU): Romanian": 2,
      "Other European language (EU): Lithuanian": 3,
      "Other European language (EU): Latvian": 2,
      "Other European language (EU): Hungarian": 6,
      "Other European language (EU): Bulgarian": 4,
      "Other European language (EU): Greek": 7,
      "Other European language (EU): Dutch": 8,
      "Other European language (EU): Swedish": 8,
      "Other European language (EU): Danish": 8,
      "Other European language (EU): Finnish": 7,
      "Other European language (EU): Estonian": 9,
      "Other European language (EU): Slovenian": 9,
      "Other European language (EU): Maltese": 5,
      "Other European language (EU): Any other European language (EU)": 8,
      "Other European language (non EU)": 7,
      "Other European language (non EU): Albanian": 7,
      "Other European language (non EU): Ukrainian": 6,
      "Other European language (non EU): Any other Eastern European language (non EU)": 8,
      "Other European language (non EU): Northern European language (non EU)": 7,
      "Other European language (EU and non-EU)": 10,
      "Other European language (EU and non-EU): Bosnian, Croatian, Serbian, and Montenegrin": 10,
      "Other European language (non-national)": 2,
      "Other European language (non-national): Any Romani language": 5,
      "Other European language (non-national): Yiddish": 1,
      "Russian": 8,
      "Turkish": 5,
      "Arabic": 8,
      "West or Central Asian language": 7,
      "West or Central Asian language: Hebrew": 5,
      "West or Central Asian language: Kurdish": 5,
      "West or Central Asian language: Persian or Farsi": 8,
      "West or Central Asian language: Pashto": 4,
      "West or Central Asian language: Any other West or Central Asian language": 8,
      "South Asian language": 2,
      "South Asian language: Urdu": 2,
      "South Asian language: Hindi": 2,
      "South Asian language: Panjabi": 1,
      "South Asian language: Pakistani Pahari (with Mirpuri and Potwari)": 1,
      "South Asian language: Bengali (with Sylheti and Chatgaya)": 3,
      "South Asian language: Gujarati": 2,
      "South Asian language: Marathi": 2,
      "South Asian language: Telugu": 1,
      "South Asian language: Tamil": 1,
      "South Asian language: Malayalam": 2,
      "South Asian language: Sinhala": 3,
      "South Asian language: Nepalese": 1,
      "South Asian language: Any other South Asian language": 2,
      "East Asian language": 8,
      "East Asian language: Mandarin Chinese": 7,
      "East Asian language: Cantonese Chinese": 6,
      "East Asian language: All other Chinese": 8,
      "East Asian language: Japanese": 7,
      "East Asian language: Korean": 6,
      "East Asian language: Vietnamese": 5,
      "East Asian language: Thai": 10,
      "East Asian language: Malay": 7,
      "East Asian language: Tagalog or Filipino": 10,
      "East Asian language: Any other East Asian language": 7,
      "Oceanic or Australian language": 1,
      "North or South American language": 4,
      "Caribbean Creole": 2,
      "Caribbean Creole: English-based Caribbean Creole": 1,
      "Caribbean Creole: Any other Caribbean Creole": 2,
      "African language": 9,
      "African language: Amharic": 10,
      "African language: Tigrinya": 9,
      "African language: Somali": 8,
      "African language: Krio": 5,
      "African language: Akan": 3,
      "African language: Yoruba": 4,
      "African language: Igbo": 3,
      "African language: Swahili or Kiswahili": 3,
      "African language: Luganda": 5,
      "African language: Lingala": 4,
      "African language: Shona": 1,
      "African language: Afrikaans": 4,
      "African language: Any other Nigerian language": 2,
      "African language: Any other West African language": 4,
      "African language: Any other African language": 6,
      "Sign language": 4,
      "Sign language: British Sign Language": 4,
      "Sign language: Any other sign language": 6,
      "Sign language: Any sign communication system": 3,
      "Other language": 6
    }
  },
  "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."
}

404

Not Found

{
  "error": "Can't find such location."
}

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!"
}