Free sandbox: try any request below on the sample suburbs, no signup. For every suburb, create an API key.

Microburbs Property Data API

Suburb - Area Statistics

Education and qualifications

GET/v1/suburbs/{suburb_name}/area-stats/education5¢ per call

How far residents went at school and the highest qualification they hold since: Year 12 to Year 8 or below, and postgraduate, bachelor, diploma and certificate levels, for every suburb and council area.

Coverage: About 10,500 suburbs and localities and 545 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/education.

Exact suburb identifier required. Exact official suburb name (SAL), e.g. Burwood (NSW) — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call GET /v1/geocode/suburb?q=<text>, then use the exact data[].area_name it returns. Suburb data endpoints do not guess a state or typo-correct names.

Authorization

Bearer tokentest

Sandbox key test works for the allowlisted GNAF + SAL — no signup.

Request

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

Path parameters

suburb_namestringrequired

Exact official suburb name (SAL), e.g. `Burwood (NSW)` — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call `GET /v1/geocode/suburb?q=<text>`, then use the exact `data[].area_name` it returns. Suburb data endpoints do not guess a state or typo-correct names.

Query parameters

fieldsstringoptional

Comma-separated subset of: total_left_school, year_12_count, year_12_pct, year_11_count, year_11_pct, year_10_count, year_10_pct, year_9_count, year_9_pct, year_8_or_below_count, year_8_or_below_pct, did_not_go_to_school_count, did_not_go_to_school_pct, school_not_stated_count, school_not_stated_pct, total_aged_15_plus, bachelor_or_higher_count, bachelor_or_higher_pct, postgraduate_degree_count, postgraduate_degree_pct, graduate_diploma_or_certificate_count, graduate_diploma_or_certificate_pct, bachelor_degree_count, bachelor_degree_pct, advanced_diploma_or_diploma_count, advanced_diploma_or_diploma_pct, certificate_count, certificate_pct, certificate_3_or_4_count, certificate_3_or_4_pct, certificate_1_or_2_count, certificate_1_or_2_pct, certificate_level_unspecified_count, certificate_level_unspecified_pct, qualification_inadequately_described_count, qualification_inadequately_described_pct, qualification_level_not_stated_count, qualification_level_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/suburbs/{suburb_name}/area-stats/education

cURL

curl --request GET \
  --url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/area-stats/education' \
  --header 'Authorization: Bearer test'

Example Responses

Show schema

{
  "data": {
    "dataset": "education",
    "level": "suburb",
    "area": "Bondi",
    "period_type": "snapshot",
    "as_of": "2021-08-10",
    "modelled": false,
    "fields": [
      {
        "field": "total_left_school",
        "name": "Residents 15 and over who have left school",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 8904
          }
        ]
      },
      {
        "field": "year_12_count",
        "name": "Year 12 or equivalent",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 7299
          }
        ]
      },
      {
        "field": "year_12_pct",
        "name": "Year 12 or equivalent: share of residents aged 15 and over who have left school",
        "unit": "%",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 81.97
          }
        ]
      }
    ]
  }
}

Successful Response200

application/json

About this dataset

About 10,500 suburbs and localities and 545 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

Two measures of education for residents aged 15 and over on 10 August 2021: the highest year of school they completed, and the level of their highest qualification after school (university degrees, diplomas and trade or other certificates). Each is a head-count and a share, with a bachelor-or-higher total.

What it shows

Highest year of school completed (Year 12, 11, 10, 9, Year 8 or below, never went to school, not stated) as a share of residents aged 15 and over who have left school, and highest post-school qualification (postgraduate degree, graduate diploma or certificate, bachelor degree, advanced diploma or diploma, certificate III or IV, certificate I or II) as a share of all residents aged 15 and over. Counts and shares are separate fields (for example bachelor_degree_count and bachelor_degree_pct).

Why use it

Education is one of the strongest signals of a suburb's income, job mix and future prices. Use it to find the most degree-qualified suburbs, to size a market for professional services, tutoring or adult education, to see where trade-qualified workers live, to compare a suburb with its council area, or to add an education profile to a suburb report. Nationally about 26% of residents aged 15 and over hold a bachelor degree or higher.

How it is built

School shares use residents aged 15 and over who are no longer at school as the base; qualification shares use all residents aged 15 and over (including people still at school and people with no post-school qualification, so the qualification shares do not add to 100). bachelor_or_higher adds postgraduate, graduate diploma or certificate, and bachelor degrees. Areas with fewer than 50 people in a base are left out of that part. 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

Field	Unit	Description
`total_left_school` Residents 15 and over who have left school	persons	Residents aged 15 and over who are no longer at school, the base for the highest-year-of-school shares.
`year_12_count` Year 12 or equivalent	persons	Number of residents aged 15 and over whose highest year of school completed is: Year 12 or equivalent (2021 snapshot). Small counts are lightly randomised for privacy.
`year_12_pct` Year 12 or equivalent: share of residents aged 15 and over who have left school	%	Year 12 or equivalent as a percent of all residents aged 15 and over who have left school in the area.
`year_11_count` Year 11 or equivalent	persons	Number of residents aged 15 and over whose highest year of school completed is: Year 11 or equivalent (2021 snapshot). Small counts are lightly randomised for privacy.
`year_11_pct` Year 11 or equivalent: share of residents aged 15 and over who have left school	%	Year 11 or equivalent as a percent of all residents aged 15 and over who have left school in the area.
`year_10_count` Year 10 or equivalent	persons	Number of residents aged 15 and over whose highest year of school completed is: Year 10 or equivalent (2021 snapshot). Small counts are lightly randomised for privacy.
`year_10_pct` Year 10 or equivalent: share of residents aged 15 and over who have left school	%	Year 10 or equivalent as a percent of all residents aged 15 and over who have left school in the area.
`year_9_count` Year 9 or equivalent	persons	Number of residents aged 15 and over whose highest year of school completed is: Year 9 or equivalent (2021 snapshot). Small counts are lightly randomised for privacy.
`year_9_pct` Year 9 or equivalent: share of residents aged 15 and over who have left school	%	Year 9 or equivalent as a percent of all residents aged 15 and over who have left school in the area.
`year_8_or_below_count` Year 8 or below	persons	Number of residents aged 15 and over whose highest year of school completed is: Year 8 or below (2021 snapshot). Small counts are lightly randomised for privacy.
`year_8_or_below_pct` Year 8 or below: share of residents aged 15 and over who have left school	%	Year 8 or below as a percent of all residents aged 15 and over who have left school in the area.
`did_not_go_to_school_count` Did not go to school	persons	Number of residents aged 15 and over whose highest year of school completed is: Did not go to school (2021 snapshot). Small counts are lightly randomised for privacy.
`did_not_go_to_school_pct` Did not go to school: share of residents aged 15 and over who have left school	%	Did not go to school as a percent of all residents aged 15 and over who have left school in the area.
`school_not_stated_count` Highest year of school not stated	persons	Number of residents aged 15 and over whose highest year of school completed is: Highest year of school not stated (2021 snapshot). Small counts are lightly randomised for privacy.
`school_not_stated_pct` Highest year of school not stated: share of residents aged 15 and over who have left school	%	Highest year of school not stated as a percent of all residents aged 15 and over who have left school in the area.
`total_aged_15_plus` Residents aged 15 and over	persons	All residents aged 15 and over, the base for the qualification shares.
`bachelor_or_higher_count` Bachelor degree or higher	persons	Number of residents aged 15 and over whose highest post-school qualification is: Bachelor degree or higher (2021 snapshot). Small counts are lightly randomised for privacy.
`bachelor_or_higher_pct` Bachelor degree or higher: share of residents aged 15 and over	%	Bachelor degree or higher as a percent of all residents aged 15 and over in the area.
`postgraduate_degree_count` Postgraduate degree	persons	Number of residents aged 15 and over whose highest post-school qualification is: Postgraduate degree (2021 snapshot). Small counts are lightly randomised for privacy.
`postgraduate_degree_pct` Postgraduate degree: share of residents aged 15 and over	%	Postgraduate degree as a percent of all residents aged 15 and over in the area.
`graduate_diploma_or_certificate_count` Graduate diploma or graduate certificate	persons	Number of residents aged 15 and over whose highest post-school qualification is: Graduate diploma or graduate certificate (2021 snapshot). Small counts are lightly randomised for privacy.
`graduate_diploma_or_certificate_pct` Graduate diploma or graduate certificate: share of residents aged 15 and over	%	Graduate diploma or graduate certificate as a percent of all residents aged 15 and over in the area.
`bachelor_degree_count` Bachelor degree	persons	Number of residents aged 15 and over whose highest post-school qualification is: Bachelor degree (2021 snapshot). Small counts are lightly randomised for privacy.
`bachelor_degree_pct` Bachelor degree: share of residents aged 15 and over	%	Bachelor degree as a percent of all residents aged 15 and over in the area.
`advanced_diploma_or_diploma_count` Advanced diploma or diploma	persons	Number of residents aged 15 and over whose highest post-school qualification is: Advanced diploma or diploma (2021 snapshot). Small counts are lightly randomised for privacy.
`advanced_diploma_or_diploma_pct` Advanced diploma or diploma: share of residents aged 15 and over	%	Advanced diploma or diploma as a percent of all residents aged 15 and over in the area.
`certificate_count` Certificate (all levels)	persons	Number of residents aged 15 and over whose highest post-school qualification is: Certificate (all levels) (2021 snapshot). Small counts are lightly randomised for privacy.
`certificate_pct` Certificate (all levels): share of residents aged 15 and over	%	Certificate (all levels) as a percent of all residents aged 15 and over in the area.
`certificate_3_or_4_count` Certificate III or IV	persons	Number of residents aged 15 and over whose highest post-school qualification is: Certificate III or IV (2021 snapshot). Small counts are lightly randomised for privacy.
`certificate_3_or_4_pct` Certificate III or IV: share of residents aged 15 and over	%	Certificate III or IV as a percent of all residents aged 15 and over in the area.
`certificate_1_or_2_count` Certificate I or II	persons	Number of residents aged 15 and over whose highest post-school qualification is: Certificate I or II (2021 snapshot). Small counts are lightly randomised for privacy.
`certificate_1_or_2_pct` Certificate I or II: share of residents aged 15 and over	%	Certificate I or II as a percent of all residents aged 15 and over in the area.
`certificate_level_unspecified_count` Certificate, level not specified	persons	Number of residents aged 15 and over whose highest post-school qualification is: Certificate, level not specified (2021 snapshot). Small counts are lightly randomised for privacy.
`certificate_level_unspecified_pct` Certificate, level not specified: share of residents aged 15 and over	%	Certificate, level not specified as a percent of all residents aged 15 and over in the area.
`qualification_inadequately_described_count` Qualification level inadequately described	persons	Number of residents aged 15 and over whose highest post-school qualification is: Qualification level inadequately described (2021 snapshot). Small counts are lightly randomised for privacy.
`qualification_inadequately_described_pct` Qualification level inadequately described: share of residents aged 15 and over	%	Qualification level inadequately described as a percent of all residents aged 15 and over in the area.
`qualification_level_not_stated_count` Qualification level not stated	persons	Number of residents aged 15 and over whose highest post-school qualification is: Qualification level not stated (2021 snapshot). Small counts are lightly randomised for privacy.
`qualification_level_not_stated_pct` Qualification level not stated: share of residents aged 15 and over	%	Qualification level not stated as a percent of all residents aged 15 and over in the area.