Occupation - minor groups
England
Wales
gethttps://crystalroof.co.uk/customer-api/work-and-travel/occupation-minor-groups/postcode/v1/{location}
Description
This method returns Census 2021 estimates that classify usual residents aged 16 years and over in employment the week before the census by occupation.
This dataset classifies what people aged 16 years and over do as their main job. Their job title or details of activities they do in their job and any supervisory or management responsibilities form this classification. This information is used to code responses to an occupation using the Standard Occupational Classification (SOC) 2020. It classifies people who were in employment between 15 March and 21 March 2021, by the SOC code that represents their current occupation. The lowest level of detail available is the four-digit SOC code which includes all codes in three, two and one digit SOC code levels.
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. 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.
|
api_key query enum | Your API key.
|
Request URL:
https://crystalroof.co.uk/customer-api/work-and-travel/occupation-minor-groups/postcode/v1/W60WW?api_key=DEMO
Possible responses with examples
Code
Description
200
Success
{
"data": {
"residents": {
"Total": 3327,
"111 Chief Executives and Senior Officials": 54,
"112 Production Managers and Directors": 44,
"113 Functional Managers and Directors": 312,
"114 Directors in Logistics, Warehousing and Transport": 0,
"115 Managers and Directors in Retail and Wholesale": 42,
"116 Senior Officers in Protective Services": 5,
"117 Health and Social Services Managers and Directors": 10,
"121 Managers and Proprietors in Agriculture Related Services": 2,
"122 Managers and Proprietors in Hospitality and Leisure Services": 52,
"123 Managers and Proprietors in Health and Care Services": 2,
"124 Managers in Logistics, Warehousing and Transport": 16,
"125 Managers and Proprietors in Other Services": 128,
"211 Natural and Social Science Professionals": 21,
"212 Engineering Professionals": 31,
"213 Information Technology Professionals": 152,
"214 Web and Multimedia Design Professionals": 24,
"215 Conservation and Environment Professionals": 4,
"216 Research and Development (R&D) and Other Research Professionals": 19,
"221 Medical Practitioners": 55,
"222 Therapy Professionals": 31,
"223 Nursing and Midwifery Professionals": 40,
"224 Veterinarians": 0,
"225 Other Health Professionals": 13,
"231 Teaching and other Educational Professionals": 146,
"232 Other Educational Professionals": 28,
"241 Legal Professionals": 90,
"242 Finance Professionals": 91,
"243 Business, Research and Administrative Professionals": 148,
"244 Business and Financial Project Management Professionals": 41,
"245 Architects, Chartered Architectural Technologists, Planning Officers, Surveyors and Construction Professionals": 28,
"246 Welfare Professionals": 17,
"247 Librarians and Related Professionals": 7,
"248 Quality and Regulatory Professionals": 13,
"249 Media Professionals": 83,
"311 Science, Engineering and Production Technicians": 10,
"312 CAD, Drawing and Architectural Technicians": 15,
"313 Information Technology Technicians": 27,
"321 Health Associate Professionals": 9,
"322 Welfare and Housing Associate Professionals": 26,
"323 Teaching and Childcare Associate Professionals": 18,
"324 Veterinary nurses": 0,
"331 Protective Service Occupations": 17,
"341 Artistic, Literary and Media Occupations": 175,
"342 Design Occupations": 25,
"343 Sports and Fitness Occupations": 28,
"351 Transport Associate Professionals": 3,
"352 Legal Associate Professionals": 8,
"353 Finance Associate Professionals": 42,
"354 Business Associate Professionals": 50,
"355 Sales, Marketing and Related Associate Professionals": 166,
"356 Public Services Associate Professionals": 5,
"357 HR, Training and Other Vocational Associate Guidance Professionals": 37,
"358 Regulatory Associate Professionals": 4,
"411 Administrative Occupations: Government and Related Organisations": 21,
"412 Administrative Occupations: Finance": 37,
"413 Administrative Occupations: Records": 31,
"414 Administrative Occupations: Office Managers and Supervisors": 33,
"415 Other Administrative Occupations": 35,
"421 Secretarial and Related Occupations": 80,
"511 Agricultural and Related Trades": 11,
"521 Metal Forming, Welding and Related Trades": 1,
"522 Metal Machining, Fitting and Instrument Making Trades": 5,
"523 Vehicle Trades": 3,
"524 Electrical and Electronic Trades": 13,
"525 Skilled Metal, Electrical and Electronic Trades Supervisors": 0,
"531 Construction and Building Trades": 26,
"532 Building Finishing Trades": 7,
"533 Construction and Building Trades Supervisors": 4,
"541 Textiles and Garments Trades": 5,
"542 Printing Trades": 1,
"543 Food Preparation and Hospitality Trades": 62,
"544 Other Skilled Trades": 7,
"611 Teaching and Childcare Support Occupations": 73,
"612 Animal Care and Control Services": 4,
"613 Caring Personal Services": 49,
"621 Leisure and Travel Services": 11,
"622 Hairdressers and Related Services": 15,
"623 Housekeeping and Related Services": 22,
"624 Cleaning and Housekeeping Managers and Supervisors": 14,
"625 Bed and Breakfast and Guest House Owners and Proprietors": 0,
"631 Community and Civil Enforcement Occupations": 1,
"711 Sales Assistants and Retail Cashiers": 91,
"712 Sales Related Occupations": 7,
"713 Shopkeepers and Sales Supervisors": 22,
"721 Customer Service Occupations": 22,
"722 Customer Service Supervisors": 0,
"811 Process Operatives": 2,
"812 Metal Working Machine Operatives": 2,
"813 Plant and Machine Operatives": 3,
"814 Assemblers and Routine Operatives": 0,
"815 Construction Operatives": 2,
"816 Production, Factory and Assembly Supervisors": 0,
"821 Road Transport Drivers": 35,
"822 Mobile Machine Drivers and Operatives": 0,
"823 Other Drivers and Transport Operatives": 3,
"911 Elementary Agricultural Occupations": 0,
"912 Elementary Construction Occupations": 9,
"913 Elementary Process Plant Occupations": 2,
"921 Elementary Administration Occupations": 6,
"922 Elementary Cleaning Occupations": 31,
"923 Elementary Security Occupations": 11,
"924 Elementary Sales Occupations": 2,
"925 Elementary Storage Occupations": 12,
"926 Other Elementary Services Occupations": 80
},
"rank": {
"111 Chief Executives and Senior Officials": 6,
"112 Production Managers and Directors": 3,
"113 Functional Managers and Directors": 8,
"114 Directors in Logistics, Warehousing and Transport": 1,
"115 Managers and Directors in Retail and Wholesale": 3,
"116 Senior Officers in Protective Services": 2,
"117 Health and Social Services Managers and Directors": 3,
"121 Managers and Proprietors in Agriculture Related Services": 1,
"122 Managers and Proprietors in Hospitality and Leisure Services": 5,
"123 Managers and Proprietors in Health and Care Services": 1,
"124 Managers in Logistics, Warehousing and Transport": 4,
"125 Managers and Proprietors in Other Services": 8,
"211 Natural and Social Science Professionals": 5,
"212 Engineering Professionals": 2,
"213 Information Technology Professionals": 7,
"214 Web and Multimedia Design Professionals": 7,
"215 Conservation and Environment Professionals": 3,
"216 Research and Development (R&D) and Other Research Professionals": 4,
"221 Medical Practitioners": 5,
"222 Therapy Professionals": 6,
"223 Nursing and Midwifery Professionals": 2,
"224 Veterinarians": 1,
"225 Other Health Professionals": 2,
"231 Teaching and other Educational Professionals": 6,
"232 Other Educational Professionals": 5,
"241 Legal Professionals": 7,
"242 Finance Professionals": 7,
"243 Business, Research and Administrative Professionals": 9,
"244 Business and Financial Project Management Professionals": 8,
"245 Architects, Chartered Architectural Technologists, Planning Officers, Surveyors and Construction Professionals": 6,
"246 Welfare Professionals": 4,
"247 Librarians and Related Professionals": 7,
"248 Quality and Regulatory Professionals": 4,
"249 Media Professionals": 8,
"311 Science, Engineering and Production Technicians": 1,
"312 CAD, Drawing and Architectural Technicians": 7,
"313 Information Technology Technicians": 5,
"321 Health Associate Professionals": 3,
"322 Welfare and Housing Associate Professionals": 4,
"323 Teaching and Childcare Associate Professionals": 3,
"324 Veterinary nurses": 1,
"331 Protective Service Occupations": 1,
"341 Artistic, Literary and Media Occupations": 8,
"342 Design Occupations": 7,
"343 Sports and Fitness Occupations": 7,
"351 Transport Associate Professionals": 3,
"352 Legal Associate Professionals": 6,
"353 Finance Associate Professionals": 6,
"354 Business Associate Professionals": 8,
"355 Sales, Marketing and Related Associate Professionals": 9,
"356 Public Services Associate Professionals": 4,
"357 HR, Training and Other Vocational Associate Guidance Professionals": 5,
"358 Regulatory Associate Professionals": 2,
"411 Administrative Occupations: Government and Related Organisations": 2,
"412 Administrative Occupations: Finance": 2,
"413 Administrative Occupations: Records": 3,
"414 Administrative Occupations: Office Managers and Supervisors": 6,
"415 Other Administrative Occupations": 1,
"421 Secretarial and Related Occupations": 6,
"511 Agricultural and Related Trades": 1,
"521 Metal Forming, Welding and Related Trades": 1,
"522 Metal Machining, Fitting and Instrument Making Trades": 1,
"523 Vehicle Trades": 1,
"524 Electrical and Electronic Trades": 1,
"525 Skilled Metal, Electrical and Electronic Trades Supervisors": 1,
"531 Construction and Building Trades": 1,
"532 Building Finishing Trades": 1,
"533 Construction and Building Trades Supervisors": 3,
"541 Textiles and Garments Trades": 3,
"542 Printing Trades": 1,
"543 Food Preparation and Hospitality Trades": 5,
"544 Other Skilled Trades": 3,
"611 Teaching and Childcare Support Occupations": 6,
"612 Animal Care and Control Services": 2,
"613 Caring Personal Services": 1,
"621 Leisure and Travel Services": 3,
"622 Hairdressers and Related Services": 2,
"623 Housekeeping and Related Services": 5,
"624 Cleaning and Housekeeping Managers and Supervisors": 6,
"625 Bed and Breakfast and Guest House Owners and Proprietors": 1,
"631 Community and Civil Enforcement Occupations": 2,
"711 Sales Assistants and Retail Cashiers": 2,
"712 Sales Related Occupations": 4,
"713 Shopkeepers and Sales Supervisors": 2,
"721 Customer Service Occupations": 2,
"722 Customer Service Supervisors": 1,
"811 Process Operatives": 1,
"812 Metal Working Machine Operatives": 1,
"813 Plant and Machine Operatives": 1,
"814 Assemblers and Routine Operatives": 1,
"815 Construction Operatives": 1,
"816 Production, Factory and Assembly Supervisors": 1,
"821 Road Transport Drivers": 1,
"822 Mobile Machine Drivers and Operatives": 1,
"823 Other Drivers and Transport Operatives": 1,
"911 Elementary Agricultural Occupations": 1,
"912 Elementary Construction Occupations": 2,
"913 Elementary Process Plant Occupations": 1,
"921 Elementary Administration Occupations": 1,
"922 Elementary Cleaning Occupations": 1,
"923 Elementary Security Occupations": 1,
"924 Elementary Sales Occupations": 1,
"925 Elementary Storage Occupations": 1,
"926 Other Elementary Services Occupations": 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."
} 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!"
} 
