Microburbs
Free sandbox: try any request below on the sample suburbs, no signup. For every suburb, create an API key.
Classic docs
Microburbs Property Data API
LGA - Area Statistics

Field of study

GET/v1/lga/{lga_name}/area-stats/field-of-study5¢ per call

What residents studied for their post-school qualification: engineering, health, management and commerce, IT, education, creative arts, trades and more, as counts and shares for every suburb and council area.

Coverage: About 8,900 suburbs and localities and 543 council areas across Australia, in all states and territories (areas with too few people or homes for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10. Full description, field list and method: /v1/datasets/field-of-study.

Authorization

Request

The only values you send. Fields under Responses below are what comes back — you never pass those.

Path parameters

lga_namestringrequired

Council (LGA) name exactly as /v1/lga/list returns it, e.g. `Lake Macquarie`.

Query parameters

fieldsstringoptional

Comma-separated subset of: total_with_qualification, natural_and_physical_sciences_count, natural_and_physical_sciences_pct, information_technology_count, information_technology_pct, engineering_count, engineering_pct, architecture_and_building_count, architecture_and_building_pct, agriculture_and_environment_count, agriculture_and_environment_pct, health_count, health_pct, education_count, education_pct, management_and_commerce_count, management_and_commerce_pct, society_and_culture_count, society_and_culture_pct, creative_arts_count, creative_arts_pct, food_hospitality_and_personal_services_count, food_hospitality_and_personal_services_pct, mixed_field_programmes_count, mixed_field_programmes_pct, field_inadequately_described_count, field_inadequately_described_pct, field_not_stated_count, field_not_stated_pct. Omit for all.

fromstringoptional

First period to include: 2020, 2020-Q3, 2020-07 or 2020-07-01.

tostringoptional

Last period to include, same formats as `from`.

Responses

Successful Response

application/json
DatasetValuesfields returned to you
datasetstringalways returned

Dataset slug; describe it with /v1/datasets/{slug}.

levelstringalways returned

suburb, lga or block.

areastringalways returned

Canonical name (or mesh-block code) of the area answered.

period_typestringalways returned

snapshot, year, financial_year, quarter or month.

as_ofstring · datealways returned

Date the dataset is current to. Values are never withheld for age; check this instead.

modelledbooleanalways returned

True when the figures are estimates from a model rather than counts or measurements.

fieldsarray of DatasetFieldSeriesalways returned
GET/v1/lga/{lga_name}/area-stats/field-of-study
cURL
curl --request GET \
  --url 'https://api.microburbs.com.au/v1/lga/Lake%20Macquarie/area-stats/field-of-study' \
  --header 'Authorization: Bearer test'
Example Responses
{
  "data": {
    "dataset": "field-of-study",
    "level": "lga",
    "area": "Waverley",
    "period_type": "snapshot",
    "as_of": "2021-08-10",
    "modelled": false,
    "fields": [
      {
        "field": "total_with_qualification",
        "name": "Residents with a post-school qualification",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 45911
          }
        ]
      },
      {
        "field": "natural_and_physical_sciences_count",
        "name": "Natural and physical sciences",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 1365
          }
        ]
      },
      {
        "field": "natural_and_physical_sciences_pct",
        "name": "Natural and physical sciences: share of residents with a post-school qualification",
        "unit": "%",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 2.97
          }
        ]
      }
    ]
  }
}
Successful Response200
application/json

About this dataset

About 8,900 suburbs and localities and 543 council areas across Australia, in all states and territories (areas with too few people or homes for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10; refreshed five-yearly.

What it is

The main field of the highest post-school qualification held by residents aged 15 and over on 10 August 2021, in twelve broad fields from natural and physical sciences to food, hospitality and personal services, for every suburb and council area.

What it shows

Qualified residents by field of study, each as a head-count and as a share of residents who hold a post-school qualification, plus the total. Counts and shares are separate fields (for example health_count and health_pct).

Why use it

Field of study shows a suburb's skills base better than job titles do: where the engineers, nurses, teachers, accountants and IT graduates live. Use it to plan recruitment or office locations, to size demand for professional services and further study, to find suburbs with a strong trade or health workforce, or to add a skills profile to a suburb report.

How it is built

The base is residents aged 15 and over who hold a post-school qualification, including those whose field or level was not stated; people with no post-school qualification are not in it. Each person is counted once, under the field of their highest qualification. Areas with fewer than 50 qualified residents are left out. Our 2021 area statistics, matched to our suburb and council-area names. Figures are a snapshot at 10 August 2021 (the latest full count), so they describe the area then, not today. To protect privacy the source lightly randomises small numbers, so a count of 0, 3 or 6 can be approximate and shares in small areas jump around: check the base field before trusting a percentage. Shares are rounded to two decimals and capped at 100.

Fields

FieldUnitDescription
total_with_qualification
Residents with a post-school qualification
personsResidents aged 15 and over holding a post-school qualification (including field not stated), the base for every share.
natural_and_physical_sciences_count
Natural and physical sciences
personsNumber of residents whose highest post-school qualification is in: Natural and physical sciences (2021 snapshot). Small counts are lightly randomised for privacy.
natural_and_physical_sciences_pct
Natural and physical sciences: share of residents with a post-school qualification
%Natural and physical sciences as a percent of all residents with a post-school qualification in the area.
information_technology_count
Information technology
personsNumber of residents whose highest post-school qualification is in: Information technology (2021 snapshot). Small counts are lightly randomised for privacy.
information_technology_pct
Information technology: share of residents with a post-school qualification
%Information technology as a percent of all residents with a post-school qualification in the area.
engineering_count
Engineering and related technologies
personsNumber of residents whose highest post-school qualification is in: Engineering and related technologies (2021 snapshot). Small counts are lightly randomised for privacy.
engineering_pct
Engineering and related technologies: share of residents with a post-school qualification
%Engineering and related technologies as a percent of all residents with a post-school qualification in the area.
architecture_and_building_count
Architecture and building
personsNumber of residents whose highest post-school qualification is in: Architecture and building (2021 snapshot). Small counts are lightly randomised for privacy.
architecture_and_building_pct
Architecture and building: share of residents with a post-school qualification
%Architecture and building as a percent of all residents with a post-school qualification in the area.
agriculture_and_environment_count
Agriculture, environmental and related studies
personsNumber of residents whose highest post-school qualification is in: Agriculture, environmental and related studies (2021 snapshot). Small counts are lightly randomised for privacy.
agriculture_and_environment_pct
Agriculture, environmental and related studies: share of residents with a post-school qualification
%Agriculture, environmental and related studies as a percent of all residents with a post-school qualification in the area.
health_count
Health
personsNumber of residents whose highest post-school qualification is in: Health (2021 snapshot). Small counts are lightly randomised for privacy.
health_pct
Health: share of residents with a post-school qualification
%Health as a percent of all residents with a post-school qualification in the area.
education_count
Education
personsNumber of residents whose highest post-school qualification is in: Education (2021 snapshot). Small counts are lightly randomised for privacy.
education_pct
Education: share of residents with a post-school qualification
%Education as a percent of all residents with a post-school qualification in the area.
management_and_commerce_count
Management and commerce
personsNumber of residents whose highest post-school qualification is in: Management and commerce (2021 snapshot). Small counts are lightly randomised for privacy.
management_and_commerce_pct
Management and commerce: share of residents with a post-school qualification
%Management and commerce as a percent of all residents with a post-school qualification in the area.
society_and_culture_count
Society and culture
personsNumber of residents whose highest post-school qualification is in: Society and culture (2021 snapshot). Small counts are lightly randomised for privacy.
society_and_culture_pct
Society and culture: share of residents with a post-school qualification
%Society and culture as a percent of all residents with a post-school qualification in the area.
creative_arts_count
Creative arts
personsNumber of residents whose highest post-school qualification is in: Creative arts (2021 snapshot). Small counts are lightly randomised for privacy.
creative_arts_pct
Creative arts: share of residents with a post-school qualification
%Creative arts as a percent of all residents with a post-school qualification in the area.
food_hospitality_and_personal_services_count
Food, hospitality and personal services
personsNumber of residents whose highest post-school qualification is in: Food, hospitality and personal services (2021 snapshot). Small counts are lightly randomised for privacy.
food_hospitality_and_personal_services_pct
Food, hospitality and personal services: share of residents with a post-school qualification
%Food, hospitality and personal services as a percent of all residents with a post-school qualification in the area.
mixed_field_programmes_count
Mixed field programmes
personsNumber of residents whose highest post-school qualification is in: Mixed field programmes (2021 snapshot). Small counts are lightly randomised for privacy.
mixed_field_programmes_pct
Mixed field programmes: share of residents with a post-school qualification
%Mixed field programmes as a percent of all residents with a post-school qualification in the area.
field_inadequately_described_count
Field of study inadequately described
personsNumber of residents whose highest post-school qualification is in: Field of study inadequately described (2021 snapshot). Small counts are lightly randomised for privacy.
field_inadequately_described_pct
Field of study inadequately described: share of residents with a post-school qualification
%Field of study inadequately described as a percent of all residents with a post-school qualification in the area.
field_not_stated_count
Field of study not stated
personsNumber of residents whose highest post-school qualification is in: Field of study not stated (2021 snapshot). Small counts are lightly randomised for privacy.
field_not_stated_pct
Field of study not stated: share of residents with a post-school qualification
%Field of study not stated as a percent of all residents with a post-school qualification in the area.