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

Birthplace

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

Where residents were born: counts and shares for the top 43 countries, plus Australia and other, in every suburb and council area.

Coverage: About 11,000 suburbs and localities and 545 council areas across Australia, in all states and territories (areas with too few residents 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/birthplace.

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_population, australia_count, australia_pct, england_count, england_pct, india_count, india_pct, china_count, china_pct, new_zealand_count, new_zealand_pct, philippines_count, philippines_pct, vietnam_count, vietnam_pct, south_africa_count, south_africa_pct, malaysia_count, malaysia_pct, italy_count, italy_pct, sri_lanka_count, sri_lanka_pct, nepal_count, nepal_pct, scotland_count, scotland_pct, south_korea_count, south_korea_pct, united_states_count, united_states_pct, germany_count, germany_pct, hong_kong_count, hong_kong_pct, iraq_count, iraq_pct, greece_count, greece_pct, pakistan_count, pakistan_pct, lebanon_count, lebanon_pct, indonesia_count, indonesia_pct, thailand_count, thailand_pct, ireland_count, ireland_pct, iran_count, iran_pct, fiji_count, fiji_pct, netherlands_count, netherlands_pct, singapore_count, singapore_pct, afghanistan_count, afghanistan_pct, bangladesh_count, bangladesh_pct, canada_count, canada_pct, taiwan_count, taiwan_pct, brazil_count, brazil_pct, poland_count, poland_pct, japan_count, japan_pct, croatia_count, croatia_pct, egypt_count, egypt_pct, north_macedonia_count, north_macedonia_pct, zimbabwe_count, zimbabwe_pct, myanmar_count, myanmar_pct, cambodia_count, cambodia_pct, turkey_count, turkey_pct, france_count, france_pct, malta_count, malta_pct, not_stated_count, not_stated_pct, other_countries_count, other_countries_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/birthplace

cURL

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

Example Responses

Show schema

{
  "data": {
    "dataset": "birthplace",
    "level": "suburb",
    "area": "Bondi",
    "period_type": "snapshot",
    "as_of": "2021-08-10",
    "modelled": false,
    "fields": [
      {
        "field": "total_population",
        "name": "Total residents",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 10411
          }
        ]
      },
      {
        "field": "australia_count",
        "name": "Australia (born in Australia): residents",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 4967
          }
        ]
      },
      {
        "field": "australia_pct",
        "name": "Australia (born in Australia): share of residents",
        "unit": "%",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 47.71
          }
        ]
      }
    ]
  }
}

Successful Response200

application/json

About this dataset

About 11,000 suburbs and localities and 545 council areas across Australia, in all states and territories (areas with too few residents for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10; refreshed five-yearly.

What it is

The country each resident was born in, as at 10 August 2021, for every suburb and council area. It covers Australia and the 43 other countries with the most residents here (England, India, China, New Zealand, the Philippines, Vietnam and so on), plus a catch-all for the rest, each as a head-count and a share of residents.

What it shows

Residents by country of birth (for example india_count, india_pct, australia_pct), the not-stated group, an other_countries remainder and total residents. Each person has one country of birth, so the fields add up to the area population.

Why use it

Where people were born is a direct read on recent migration and the communities moving into an area. Use it to find suburbs with the most Indian-, Chinese- or Nepali-born residents, to spot fast-changing areas, to size services for newly arrived communities, or to add a "born overseas" profile to a report. For ancestry (which includes the children and grandchildren of migrants) see ancestry.

How it is built

Areas with fewer than 50 residents are left out because every small number is randomised. 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 who lived there then, not today. To protect privacy the source lightly randomises small numbers, so a count of 0, 3 or 6 can be approximate; shares for tiny suburbs jump around, so check the total residents field before trusting a percentage. Each resident has exactly one country of birth. China excludes Hong Kong, Macau and Taiwan, which are separate fields. other_countries is the remainder after the listed countries and not stated, so it can be slightly off in tiny areas where randomisation applies.

Fields

Field	Unit	Description
`total_population` Total residents	persons	All residents counted in the area on 10 August 2021, the base for every share in this dataset.
`australia_count` Australia (born in Australia): residents	persons	Number of residents who were born in Australia (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`australia_pct` Australia (born in Australia): share of residents	%	Residents born in Australia as a percent of all residents in the area.
`england_count` England: residents	persons	Number of residents who were born in England (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`england_pct` England: share of residents	%	Residents born in England as a percent of all residents in the area.
`india_count` India: residents	persons	Number of residents who were born in India (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`india_pct` India: share of residents	%	Residents born in India as a percent of all residents in the area.
`china_count` China (excluding Hong Kong, Macau and Taiwan): residents	persons	Number of residents who were born in China (excluding Hong Kong, Macau and Taiwan) (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`china_pct` China (excluding Hong Kong, Macau and Taiwan): share of residents	%	Residents born in China (excluding Hong Kong, Macau and Taiwan) as a percent of all residents in the area.
`new_zealand_count` New Zealand: residents	persons	Number of residents who were born in New Zealand (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`new_zealand_pct` New Zealand: share of residents	%	Residents born in New Zealand as a percent of all residents in the area.
`philippines_count` Philippines: residents	persons	Number of residents who were born in Philippines (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`philippines_pct` Philippines: share of residents	%	Residents born in Philippines as a percent of all residents in the area.
`vietnam_count` Vietnam: residents	persons	Number of residents who were born in Vietnam (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`vietnam_pct` Vietnam: share of residents	%	Residents born in Vietnam as a percent of all residents in the area.
`south_africa_count` South Africa: residents	persons	Number of residents who were born in South Africa (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`south_africa_pct` South Africa: share of residents	%	Residents born in South Africa as a percent of all residents in the area.
`malaysia_count` Malaysia: residents	persons	Number of residents who were born in Malaysia (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`malaysia_pct` Malaysia: share of residents	%	Residents born in Malaysia as a percent of all residents in the area.
`italy_count` Italy: residents	persons	Number of residents who were born in Italy (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`italy_pct` Italy: share of residents	%	Residents born in Italy as a percent of all residents in the area.
`sri_lanka_count` Sri Lanka: residents	persons	Number of residents who were born in Sri Lanka (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`sri_lanka_pct` Sri Lanka: share of residents	%	Residents born in Sri Lanka as a percent of all residents in the area.
`nepal_count` Nepal: residents	persons	Number of residents who were born in Nepal (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`nepal_pct` Nepal: share of residents	%	Residents born in Nepal as a percent of all residents in the area.
`scotland_count` Scotland: residents	persons	Number of residents who were born in Scotland (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`scotland_pct` Scotland: share of residents	%	Residents born in Scotland as a percent of all residents in the area.
`south_korea_count` South Korea: residents	persons	Number of residents who were born in South Korea (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`south_korea_pct` South Korea: share of residents	%	Residents born in South Korea as a percent of all residents in the area.
`united_states_count` United States: residents	persons	Number of residents who were born in United States (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`united_states_pct` United States: share of residents	%	Residents born in United States as a percent of all residents in the area.
`germany_count` Germany: residents	persons	Number of residents who were born in Germany (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`germany_pct` Germany: share of residents	%	Residents born in Germany as a percent of all residents in the area.
`hong_kong_count` Hong Kong: residents	persons	Number of residents who were born in Hong Kong (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`hong_kong_pct` Hong Kong: share of residents	%	Residents born in Hong Kong as a percent of all residents in the area.
`iraq_count` Iraq: residents	persons	Number of residents who were born in Iraq (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`iraq_pct` Iraq: share of residents	%	Residents born in Iraq as a percent of all residents in the area.
`greece_count` Greece: residents	persons	Number of residents who were born in Greece (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`greece_pct` Greece: share of residents	%	Residents born in Greece as a percent of all residents in the area.
`pakistan_count` Pakistan: residents	persons	Number of residents who were born in Pakistan (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`pakistan_pct` Pakistan: share of residents	%	Residents born in Pakistan as a percent of all residents in the area.
`lebanon_count` Lebanon: residents	persons	Number of residents who were born in Lebanon (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`lebanon_pct` Lebanon: share of residents	%	Residents born in Lebanon as a percent of all residents in the area.
`indonesia_count` Indonesia: residents	persons	Number of residents who were born in Indonesia (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`indonesia_pct` Indonesia: share of residents	%	Residents born in Indonesia as a percent of all residents in the area.
`thailand_count` Thailand: residents	persons	Number of residents who were born in Thailand (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`thailand_pct` Thailand: share of residents	%	Residents born in Thailand as a percent of all residents in the area.
`ireland_count` Ireland: residents	persons	Number of residents who were born in Ireland (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`ireland_pct` Ireland: share of residents	%	Residents born in Ireland as a percent of all residents in the area.
`iran_count` Iran: residents	persons	Number of residents who were born in Iran (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`iran_pct` Iran: share of residents	%	Residents born in Iran as a percent of all residents in the area.
`fiji_count` Fiji: residents	persons	Number of residents who were born in Fiji (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`fiji_pct` Fiji: share of residents	%	Residents born in Fiji as a percent of all residents in the area.
`netherlands_count` Netherlands: residents	persons	Number of residents who were born in Netherlands (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`netherlands_pct` Netherlands: share of residents	%	Residents born in Netherlands as a percent of all residents in the area.
`singapore_count` Singapore: residents	persons	Number of residents who were born in Singapore (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`singapore_pct` Singapore: share of residents	%	Residents born in Singapore as a percent of all residents in the area.
`afghanistan_count` Afghanistan: residents	persons	Number of residents who were born in Afghanistan (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`afghanistan_pct` Afghanistan: share of residents	%	Residents born in Afghanistan as a percent of all residents in the area.
`bangladesh_count` Bangladesh: residents	persons	Number of residents who were born in Bangladesh (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`bangladesh_pct` Bangladesh: share of residents	%	Residents born in Bangladesh as a percent of all residents in the area.
`canada_count` Canada: residents	persons	Number of residents who were born in Canada (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`canada_pct` Canada: share of residents	%	Residents born in Canada as a percent of all residents in the area.
`taiwan_count` Taiwan: residents	persons	Number of residents who were born in Taiwan (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`taiwan_pct` Taiwan: share of residents	%	Residents born in Taiwan as a percent of all residents in the area.
`brazil_count` Brazil: residents	persons	Number of residents who were born in Brazil (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`brazil_pct` Brazil: share of residents	%	Residents born in Brazil as a percent of all residents in the area.
`poland_count` Poland: residents	persons	Number of residents who were born in Poland (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`poland_pct` Poland: share of residents	%	Residents born in Poland as a percent of all residents in the area.
`japan_count` Japan: residents	persons	Number of residents who were born in Japan (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`japan_pct` Japan: share of residents	%	Residents born in Japan as a percent of all residents in the area.
`croatia_count` Croatia: residents	persons	Number of residents who were born in Croatia (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`croatia_pct` Croatia: share of residents	%	Residents born in Croatia as a percent of all residents in the area.
`egypt_count` Egypt: residents	persons	Number of residents who were born in Egypt (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`egypt_pct` Egypt: share of residents	%	Residents born in Egypt as a percent of all residents in the area.
`north_macedonia_count` North Macedonia: residents	persons	Number of residents who were born in North Macedonia (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`north_macedonia_pct` North Macedonia: share of residents	%	Residents born in North Macedonia as a percent of all residents in the area.
`zimbabwe_count` Zimbabwe: residents	persons	Number of residents who were born in Zimbabwe (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`zimbabwe_pct` Zimbabwe: share of residents	%	Residents born in Zimbabwe as a percent of all residents in the area.
`myanmar_count` Myanmar: residents	persons	Number of residents who were born in Myanmar (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`myanmar_pct` Myanmar: share of residents	%	Residents born in Myanmar as a percent of all residents in the area.
`cambodia_count` Cambodia: residents	persons	Number of residents who were born in Cambodia (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`cambodia_pct` Cambodia: share of residents	%	Residents born in Cambodia as a percent of all residents in the area.
`turkey_count` Turkey: residents	persons	Number of residents who were born in Turkey (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`turkey_pct` Turkey: share of residents	%	Residents born in Turkey as a percent of all residents in the area.
`france_count` France: residents	persons	Number of residents who were born in France (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`france_pct` France: share of residents	%	Residents born in France as a percent of all residents in the area.
`malta_count` Malta: residents	persons	Number of residents who were born in Malta (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`malta_pct` Malta: share of residents	%	Residents born in Malta as a percent of all residents in the area.
`not_stated_count` Country of birth not stated: residents	persons	Number of residents whose country of birth was not stated.
`not_stated_pct` Country of birth not stated: share of residents	%	Residents whose country of birth was not stated, as a percent of all residents.
`other_countries_count` Other countries (born in a country not listed here): residents	persons	Number of residents who were born in Other countries (born in a country not listed here) (2021 snapshot). Each resident has one country of birth, so the countries add to the area's population. Small counts are lightly randomised for privacy.
`other_countries_pct` Other countries (born in a country not listed here): share of residents	%	Residents born in Other countries (born in a country not listed here) as a percent of all residents in the area.