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

Labour force status

GET/v1/lga/{lga_name}/area-stats/labour-force5¢ per call

Who works full-time or part-time, who is unemployed and looking, and who is outside the workforce, with the unemployment and participation rates, 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/labour-force.

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_aged_15_plus, employed_count, employed_pct, employed_full_time_count, employed_full_time_pct, employed_part_time_count, employed_part_time_pct, employed_away_from_work_count, employed_away_from_work_pct, unemployed_count, unemployed_pct, labour_force_count, labour_force_pct, not_in_labour_force_count, not_in_labour_force_pct, unemployment_rate. 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/labour-force
cURL
curl --request GET \
  --url 'https://api.microburbs.com.au/v1/lga/Lake%20Macquarie/area-stats/labour-force' \
  --header 'Authorization: Bearer test'
Example Responses
{
  "data": {
    "dataset": "labour-force",
    "level": "lga",
    "area": "Waverley",
    "period_type": "snapshot",
    "as_of": "2021-08-10",
    "modelled": false,
    "fields": [
      {
        "field": "total_aged_15_plus",
        "name": "Residents aged 15 and over",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 57794
          }
        ]
      },
      {
        "field": "employed_count",
        "name": "Employed",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 38229
          }
        ]
      },
      {
        "field": "employed_pct",
        "name": "Employed: share of residents aged 15 and over",
        "unit": "%",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 66.15
          }
        ]
      }
    ]
  }
}
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

The labour force status of residents aged 15 and over in the week before 10 August 2021, for every suburb and council area: employed full-time, employed part-time, employed but away from work, unemployed and looking for work, and not in the labour force, with the unemployment rate, the participation rate and the employment-to-population ratio.

What it shows

Residents aged 15 and over by labour force status, each as a head-count and as a share of residents aged 15 and over, plus the total. Counts and shares are separate fields (for example employed_full_time_count and employed_full_time_pct). unemployment_rate is unemployed as a share of the labour force; labour_force_pct is the participation rate and employed_pct the employment-to-population ratio.

Why use it

Work status sets a suburb's spending power and its daytime population. Use it to compare unemployment and participation between suburbs, to find areas with many part-time workers or many people outside the workforce (retirees, students, carers), to size a local labour pool, or to add an employment profile to a suburb report. For the headline unemployment rate with its national benchmark and street-level detail see demographics/unemployment.

How it is built

The base is residents aged 15 and over; people who did not state their status are in the base but not in any group, so the groups add to a little under 100. Employed is full-time plus part-time plus away from work; full-time means 35 hours or more in all jobs that week. The labour force is employed plus unemployed. COVID-19 lockdowns in Greater Sydney, Melbourne and parts of regional New South Wales and Victoria meant many employed people were away from work or on reduced hours that week. Areas with fewer than 50 residents aged 15 and over are left out; unemployment_rate needs a labour force of at least 20. 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_aged_15_plus
Residents aged 15 and over
personsAll residents aged 15 and over, the base for every share.
employed_count
Employed
personsNumber of residents aged 15 and over in the area who are: Employed (2021 snapshot). Small counts are lightly randomised for privacy.
employed_pct
Employed: share of residents aged 15 and over
%Employed as a percent of all residents aged 15 and over in the area.
employed_full_time_count
Employed, worked full-time
personsNumber of residents aged 15 and over in the area who are: Employed, worked full-time (2021 snapshot). Small counts are lightly randomised for privacy.
employed_full_time_pct
Employed, worked full-time: share of residents aged 15 and over
%Employed, worked full-time as a percent of all residents aged 15 and over in the area.
employed_part_time_count
Employed, worked part-time
personsNumber of residents aged 15 and over in the area who are: Employed, worked part-time (2021 snapshot). Small counts are lightly randomised for privacy.
employed_part_time_pct
Employed, worked part-time: share of residents aged 15 and over
%Employed, worked part-time as a percent of all residents aged 15 and over in the area.
employed_away_from_work_count
Employed, away from work
personsNumber of residents aged 15 and over in the area who are: Employed, away from work (2021 snapshot). Small counts are lightly randomised for privacy.
employed_away_from_work_pct
Employed, away from work: share of residents aged 15 and over
%Employed, away from work as a percent of all residents aged 15 and over in the area.
unemployed_count
Unemployed, looking for work
personsNumber of residents aged 15 and over in the area who are: Unemployed, looking for work (2021 snapshot). Small counts are lightly randomised for privacy.
unemployed_pct
Unemployed, looking for work: share of residents aged 15 and over
%Unemployed, looking for work as a percent of all residents aged 15 and over in the area.
labour_force_count
In the labour force (employed or unemployed)
personsNumber of residents aged 15 and over in the area who are: In the labour force (employed or unemployed) (2021 snapshot). Small counts are lightly randomised for privacy.
labour_force_pct
In the labour force (employed or unemployed): share of residents aged 15 and over
%In the labour force (employed or unemployed) as a percent of all residents aged 15 and over in the area.
not_in_labour_force_count
Not in the labour force
personsNumber of residents aged 15 and over in the area who are: Not in the labour force (2021 snapshot). Small counts are lightly randomised for privacy.
not_in_labour_force_pct
Not in the labour force: share of residents aged 15 and over
%Not in the labour force as a percent of all residents aged 15 and over in the area.
unemployment_rate
Unemployment rate
%Unemployed residents as a percent of the labour force (employed plus unemployed), 2021 snapshot.