Age of arrival in the UK

England

Wales

gethttps://crystalroof.co.uk/customer-api/demographics-and-migration/age-of-arrival-in-the-uk/postcode/v1/{location}

Description

This method returns Census 2021 estimates that classify usual residents by their age of arrival in the UK.

Age of arrival in the UK is derived from the date a person last arrived to live in the UK and their age. Arrival dates do not include returning from short trips away from the UK. Age of arrival only applies to usual residents not born in the UK. It does not include usual residents born in the UK who have emigrated and since returned. These are recorded in the category "born in the UK".

Age of arrival in the UK is split into 19 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. oa - Output area (OA), the smallest geographical area used in the census, comprises 25-40 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. 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/demographics-and-migration/age-of-arrival-in-the-uk/postcode/v1/W60WW?api_key=DEMO

Possible responses with examples

Code

Description

200

Success

{
  "data": {
    "residents": {
      "Total": 197,
      "Born in the UK": 101,
      "Arrived in the UK": 96,
      "Arrived in the UK: Aged 0 to 4 years": 3,
      "Arrived in the UK: Aged 5 to 7 years": 1,
      "Arrived in the UK: Aged 8 to 9 years": 1,
      "Arrived in the UK: Aged 10 to 14 years": 5,
      "Arrived in the UK: Aged 15 years": 0,
      "Arrived in the UK: Aged 16 to 17 years": 5,
      "Arrived in the UK: Aged 18 to 19 years": 9,
      "Arrived in the UK: Aged 20 to 24 years": 16,
      "Arrived in the UK: Aged 25 to 29 years": 16,
      "Arrived in the UK: Aged 30 to 44 years": 29,
      "Arrived in the UK: Aged 45 to 59 years": 7,
      "Arrived in the UK: Aged 60 to 64 years": 2,
      "Arrived in the UK: Aged 65 to 74 years": 2,
      "Arrived in the UK: Aged 75 to 84 years": 0,
      "Arrived in the UK: Aged 85 to 89 years": 0,
      "Arrived in the UK: Aged 90 years and over": 0
    },
    "rank": {
      "Born in the UK": 3,
      "Arrived in the UK": 8,
      "Arrived in the UK: Aged 0 to 4 years": 3,
      "Arrived in the UK: Aged 5 to 7 years": 3,
      "Arrived in the UK: Aged 8 to 9 years": 3,
      "Arrived in the UK: Aged 10 to 14 years": 5,
      "Arrived in the UK: Aged 15 years": 1,
      "Arrived in the UK: Aged 16 to 17 years": 6,
      "Arrived in the UK: Aged 18 to 19 years": 6,
      "Arrived in the UK: Aged 20 to 24 years": 6,
      "Arrived in the UK: Aged 25 to 29 years": 6,
      "Arrived in the UK: Aged 30 to 44 years": 8,
      "Arrived in the UK: Aged 45 to 59 years": 6,
      "Arrived in the UK: Aged 60 to 64 years": 6,
      "Arrived in the UK: Aged 65 to 74 years": 6,
      "Arrived in the UK: Aged 75 to 84 years": 1,
      "Arrived in the UK: Aged 85 to 89 years": 1,
      "Arrived in the UK: Aged 90 years and over": 1
    }
  },
  "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!"
}