National identity (detailed)

England

Wales

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

Description

This method returns Census 2021 estimates that classify usual residents by their national identity.

Someone's national identity is a self-determined assessment of their own identity, it could be the country or countries where they feel they belong or think of as home. It is not dependent on ethnic group or citizenship. Respondents could select more than one national identity.

National identity is split into 91 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. 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. 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/national-identity-detailed/postcode/v1/W60WW?api_key=DEMO

Possible responses with examples

Code

Description

200

Success

{
  "data": {
    "residents": {
      "Total": 6195,
      "UK identity": 4492,
      "UK identity: British only identity": 3178,
      "UK identity: English only identity": 339,
      "UK identity: English and British only identity": 443,
      "UK identity:  Welsh only identity": 34,
      "UK identity: Welsh and British only identity": 13,
      "UK identity: Scottish only identity": 35,
      "UK identity:  Scottish and British only identity": 13,
      "UK identity: Northern Irish only identity": 14,
      "UK identity: Northern Irish and British only identity": 8,
      "UK identity: Cornish only identity": 1,
      "UK identity: Cornish and British only identity": 0,
      "UK identity: Any other combination of UK identities (UK only)": 19,
      "UK identity: Other identity and at least one UK identity ": 395,
      "Other identity only": 1703,
      "Other identity only: Guernsey Islander": 0,
      "Other identity only: Jersey Islander": 0,
      "Other identity only: Isle of Man (Manx)": 1,
      "Other identity only: Channel Islander not otherwise specified": 0,
      "Other identity only: Irish only identity": 107,
      "Other identity only: Irish and at least one UK identity": 26,
      "Other identity only: European": 859,
      "Other identity only: European: EU countries": 693,
      "Other identity only: European: EU countries: French": 110,
      "Other identity only: European: EU countries: German": 26,
      "Other identity only: European: EU countries: Italian": 136,
      "Other identity only: European: EU countries: Portuguese": 29,
      "Other identity only: European: EU countries: Spanish (including Canary Islander)": 95,
      "Other identity only: European: EU countries: Other member countries in March 2001": 94,
      "Other identity only: European: EU countries:  Lithuanian": 25,
      "Other identity only: European: EU countries:  Polish": 68,
      "Other identity only: European: EU countries: Romanian": 38,
      "Other identity only: European: EU countries: Other member countries": 72,
      "Other identity only: European: Non-EU countries": 166,
      "Other identity only: European: Non-EU countries: Turkish": 11,
      "Other identity only: European: Non-EU countries: Other European": 155,
      "Other identity only: African": 83,
      "Other identity only: African: North African": 27,
      "Other identity only: African: Central and Western African": 31,
      "Other identity only: African: Central and Western African: Ghanaian": 6,
      "Other identity only: African: Central and Western African: Nigerian": 10,
      "Other identity only: African: Central and Western African: Other Central and Western African": 15,
      "Other identity only: African: South and Eastern African": 25,
      "Other identity only: African: South and Eastern African: Kenyan": 0,
      "Other identity only: African: South and Eastern African: Somali": 2,
      "Other identity only: African: South and Eastern African: South African": 5,
      "Other identity only: African: South and Eastern African: Zimbabwean": 4,
      "Other identity only: African: South and Eastern African: Other South and Eastern African": 14,
      "Other identity only: Middle Eastern and Asian": 358,
      "Other identity only: Middle Eastern and Asian: Middle Eastern": 54,
      "Other identity only: Middle Eastern and Asian: Middle Eastern: Kurdish": 3,
      "Other identity only: Middle Eastern and Asian: Middle Eastern: Iranian": 30,
      "Other identity only: Middle Eastern and Asian: Middle Eastern: Iraqi": 5,
      "Other identity only: Middle Eastern and Asian: Middle Eastern: Other Middle Eastern": 16,
      "Other identity only: Middle Eastern and Asian: Eastern Asian": 172,
      "Other identity only: Middle Eastern and Asian: Eastern Asian: Chinese": 103,
      "Other identity only: Middle Eastern and Asian: Eastern Asian: Hong Kong Chinese": 24,
      "Other identity only: Middle Eastern and Asian: Eastern Asian: Japanese": 25,
      "Other identity only: Middle Eastern and Asian: Eastern Asian: Other Eastern Asian": 20,
      "Other identity only: Middle Eastern and Asian: Southern Asian": 68,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Afghan": 5,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Bangladeshi": 2,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Indian": 42,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Pakistani": 12,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Sri Lankan": 1,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Other Southern Asian": 6,
      "Other identity only: Middle Eastern and Asian: South-East Asian": 55,
      "Other identity only: Middle Eastern and Asian: South-East Asian: Filipino": 26,
      "Other identity only: Middle Eastern and Asian: South-East Asian: Malaysian": 10,
      "Other identity only: Middle Eastern and Asian: South-East Asian: Singaporean": 2,
      "Other identity only: Middle Eastern and Asian: South-East Asian: Other South-East Asian": 17,
      "Other identity only: Middle Eastern and Asian: Central Asian": 3,
      "Other identity only: Middle Eastern and Asian: Asian not otherwise specified": 6,
      "Other identity only: American and Caribbean": 171,
      "Other identity only: American and Caribbean: North American": 108,
      "Other identity only: American and Caribbean: North American: Canadian": 19,
      "Other identity only: American and Caribbean: North American: US Citizen": 87,
      "Other identity only: American and Caribbean: North American: Other North American": 2,
      "Other identity only: American and Caribbean: Central American": 8,
      "Other identity only: American and Caribbean: South American": 45,
      "Other identity only: American and Caribbean: Caribbean": 10,
      "Other identity only: American and Caribbean: Caribbean: Jamaican": 5,
      "Other identity only: American and Caribbean: Caribbean: Other Caribbean": 5,
      "Other identity only: Antarctican and Oceanian": 61,
      "Other identity only: Antarctican and Oceanian: Australasian": 59,
      "Other identity only: Antarctican and Oceanian: Australasian: Australian": 42,
      "Other identity only: Antarctican and Oceanian: Australasian: New Zealander": 17,
      "Other identity only: Antarctican and Oceanian: Australasian: Other Australasian": 0,
      "Other identity only: Antarctican and Oceanian: Other Oceanian": 2,
      "Other identity only: Other": 37
    },
    "rank": {
      "UK identity": 3,
      "UK identity: British only identity": 5,
      "UK identity: English only identity": 2,
      "UK identity: English and British only identity": 3,
      "UK identity:  Welsh only identity": 1,
      "UK identity: Welsh and British only identity": 2,
      "UK identity: Scottish only identity": 5,
      "UK identity:  Scottish and British only identity": 4,
      "UK identity: Northern Irish only identity": 5,
      "UK identity: Northern Irish and British only identity": 6,
      "UK identity: Cornish only identity": 1,
      "UK identity: Cornish and British only identity": 1,
      "UK identity: Any other combination of UK identities (UK only)": 4,
      "UK identity: Other identity and at least one UK identity ": 9,
      "Other identity only": 8,
      "Other identity only: Guernsey Islander": 1,
      "Other identity only: Jersey Islander": 1,
      "Other identity only: Isle of Man (Manx)": 4,
      "Other identity only: Channel Islander not otherwise specified": 1,
      "Other identity only: Irish only identity": 8,
      "Other identity only: Irish and at least one UK identity": 9,
      "Other identity only: European": 7,
      "Other identity only: European: EU countries": 6,
      "Other identity only: European: EU countries: French": 7,
      "Other identity only: European: EU countries: German": 5,
      "Other identity only: European: EU countries: Italian": 7,
      "Other identity only: European: EU countries: Portuguese": 2,
      "Other identity only: European: EU countries: Spanish (including Canary Islander)": 6,
      "Other identity only: European: EU countries: Other member countries in March 2001": 6,
      "Other identity only: European: EU countries:  Lithuanian": 3,
      "Other identity only: European: EU countries:  Polish": 3,
      "Other identity only: European: EU countries: Romanian": 2,
      "Other identity only: European: EU countries: Other member countries": 4,
      "Other identity only: European: Non-EU countries": 8,
      "Other identity only: European: Non-EU countries: Turkish": 4,
      "Other identity only: European: Non-EU countries: Other European": 9,
      "Other identity only: African": 4,
      "Other identity only: African: North African": 6,
      "Other identity only: African: Central and Western African": 3,
      "Other identity only: African: Central and Western African: Ghanaian": 2,
      "Other identity only: African: Central and Western African: Nigerian": 2,
      "Other identity only: African: Central and Western African: Other Central and Western African": 4,
      "Other identity only: African: South and Eastern African": 4,
      "Other identity only: African: South and Eastern African: Kenyan": 1,
      "Other identity only: African: South and Eastern African: Somali": 2,
      "Other identity only: African: South and Eastern African: South African": 3,
      "Other identity only: African: South and Eastern African: Zimbabwean": 3,
      "Other identity only: African: South and Eastern African: Other South and Eastern African": 4,
      "Other identity only: Middle Eastern and Asian": 6,
      "Other identity only: Middle Eastern and Asian: Middle Eastern": 5,
      "Other identity only: Middle Eastern and Asian: Middle Eastern: Kurdish": 2,
      "Other identity only: Middle Eastern and Asian: Middle Eastern: Iranian": 7,
      "Other identity only: Middle Eastern and Asian: Middle Eastern: Iraqi": 4,
      "Other identity only: Middle Eastern and Asian: Middle Eastern: Other Middle Eastern": 3,
      "Other identity only: Middle Eastern and Asian: Eastern Asian": 6,
      "Other identity only: Middle Eastern and Asian: Eastern Asian: Chinese": 5,
      "Other identity only: Middle Eastern and Asian: Eastern Asian: Hong Kong Chinese": 6,
      "Other identity only: Middle Eastern and Asian: Eastern Asian: Japanese": 5,
      "Other identity only: Middle Eastern and Asian: Eastern Asian: Other Eastern Asian": 5,
      "Other identity only: Middle Eastern and Asian: Southern Asian": 3,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Afghan": 3,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Bangladeshi": 1,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Indian": 3,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Pakistani": 2,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Sri Lankan": 1,
      "Other identity only: Middle Eastern and Asian: Southern Asian: Other Southern Asian": 2,
      "Other identity only: Middle Eastern and Asian: South-East Asian": 6,
      "Other identity only: Middle Eastern and Asian: South-East Asian: Filipino": 5,
      "Other identity only: Middle Eastern and Asian: South-East Asian: Malaysian": 5,
      "Other identity only: Middle Eastern and Asian: South-East Asian: Singaporean": 3,
      "Other identity only: Middle Eastern and Asian: South-East Asian: Other South-East Asian": 6,
      "Other identity only: Middle Eastern and Asian: Central Asian": 4,
      "Other identity only: Middle Eastern and Asian: Asian not otherwise specified": 3,
      "Other identity only: American and Caribbean": 5,
      "Other identity only: American and Caribbean: North American": 5,
      "Other identity only: American and Caribbean: North American: Canadian": 6,
      "Other identity only: American and Caribbean: North American: US Citizen": 5,
      "Other identity only: American and Caribbean: North American: Other North American": 6,
      "Other identity only: American and Caribbean: Central American": 6,
      "Other identity only: American and Caribbean: South American": 6,
      "Other identity only: American and Caribbean: Caribbean": 3,
      "Other identity only: American and Caribbean: Caribbean: Jamaican": 3,
      "Other identity only: American and Caribbean: Caribbean: Other Caribbean": 3,
      "Other identity only: Antarctican and Oceanian": 7,
      "Other identity only: Antarctican and Oceanian: Australasian": 6,
      "Other identity only: Antarctican and Oceanian: Australasian: Australian": 6,
      "Other identity only: Antarctican and Oceanian: Australasian: New Zealander": 6,
      "Other identity only: Antarctican and Oceanian: Australasian: Other Australasian": 1,
      "Other identity only: Antarctican and Oceanian: Other Oceanian": 3,
      "Other identity only: Other": 8
    }
  },
  "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!"
}