Owner-occupation and housing tenure rates
/v1/suburbs/{suburb_name}/demographics/tenure10¢ per callExplicit total owner-occupation rate plus owned-outright / mortgaged /
renting / public-housing shares — a suburb rollup and the per-microburb
downscaled Census shares. owner_occupied_pct is the requested headline;
it equals owned outright plus mortgaged and is null if either is absent.
census_year makes the 2021 reference period explicit.
Exact suburb identifier required. Exact ABS Suburb and Locality (SAL) name, 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.
Price: 10¢ per call.
Authorization
Request
The only values you send. Fields under Responses below are what comes back — you never pass those.
Path parameters
suburb_namestringrequiredExact ABS Suburb and Locality (SAL) name, 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
Responses
Successful Response
suburbstringalways returnedThe suburb these figures describe, as the canonical ABS suburb (SAL) name — the resolved form of whatever was requested.
census_yearintegermay be nullReference year of the underlying ABS Census tenure inputs (currently 2021). This is not a current-year occupancy survey.
owned_outright_pctnumbermay be nullSuburb-wide share of dwellings owned outright, percent 0–100.
mortgaged_pctnumbermay be nullSuburb-wide share owner-occupied with a mortgage, percent 0–100.
owner_occupied_pctnumbermay be nullTotal suburb owner-occupation rate, percent 0–100: `owned_outright_pct + mortgaged_pct`. Null unless both components are available. This is a modelled, unweighted average across microburbs, not an exact dwelling-weighted ABS SAL count.
renting_pctnumbermay be nullSuburb-wide share of dwellings rented, percent 0–100 — private and public renting combined. Drives `tier`.
public_housing_pctnumbermay be nullSuburb-wide share rented from a state/territory housing authority, percent 0–100. Included within `renting_pct`, not additional to it.
tierstringalways returnedOne-word read on the suburb's ownership mix, banded on `renting_pct`: 'Owner-Occupier' under 7% renters, 'Mixed' under 20%, 'Investor-Heavy' at 20% or above ('Unknown' when there is no renting share). A convenience label — the underlying percentage is the precise figure.
n_microburbsintegeralways returnedHow many microburbs are listed in `microburbs`. Not the number behind the suburb figures above: very small or sparsely-populated microburbs are filtered out of the list but still counted in the suburb averages, so re-averaging `microburbs` will not exactly reproduce them.
microburbsarray of TenureMbalways returnedTenure shares for each microburb in the suburb, showing how ownership varies street by street — often the more useful signal, since a single suburb average can hide an owner-occupied pocket next to a rental-heavy one.
/v1/suburbs/{suburb_name}/demographics/tenurecurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/demographics/tenure' \
--header 'Authorization: Bearer test'{
"data": {
"census_year": 2021,
"microburbs": [
{
"mb": "10664530000",
"mortgaged_pct": 41,
"owned_outright_pct": 38.2,
"public_housing_pct": 0.9,
"renting_pct": 17.3,
"street": "Marquis St"
}
],
"mortgaged_pct": 40.1,
"n_microburbs": 71,
"owned_outright_pct": 34.7,
"owner_occupied_pct": 74.8,
"public_housing_pct": 1.8,
"renting_pct": 20.9,
"suburb": "Belmont North",
"tier": "Mixed"
}
}