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

Rent payments

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

What renting households actually pay: weekly rent in 14 bands from under $75 to $950 or more, the median weekly rent, and who the landlord is (agent, private owner, public or community housing), for every suburb and council area.

Coverage: About 5,400 suburbs and localities and 536 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/rent-payments.

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_renting_households, rent_1_74_count, rent_1_74_pct, rent_75_99_count, rent_75_99_pct, rent_100_149_count, rent_100_149_pct, rent_150_199_count, rent_150_199_pct, rent_200_224_count, rent_200_224_pct, rent_225_274_count, rent_225_274_pct, rent_275_349_count, rent_275_349_pct, rent_350_449_count, rent_350_449_pct, rent_450_549_count, rent_450_549_pct, rent_550_649_count, rent_550_649_pct, rent_650_749_count, rent_650_749_pct, rent_750_849_count, rent_750_849_pct, rent_850_949_count, rent_850_949_pct, rent_950_plus_count, rent_950_plus_pct, rent_not_stated_count, rent_not_stated_pct, landlord_real_estate_agent_count, landlord_real_estate_agent_pct, landlord_private_person_count, landlord_private_person_pct, landlord_state_housing_count, landlord_state_housing_pct, landlord_community_housing_count, landlord_community_housing_pct, landlord_other_count, landlord_other_pct, landlord_not_stated_count, landlord_not_stated_pct, median_rent_weekly. 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/rent-payments

cURL

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

Example Responses

Show schema

{
  "data": {
    "dataset": "rent-payments",
    "level": "suburb",
    "area": "Bondi",
    "period_type": "snapshot",
    "as_of": "2021-08-10",
    "modelled": false,
    "fields": [
      {
        "field": "total_renting_households",
        "name": "Renting households",
        "unit": "households",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 2547
          }
        ]
      },
      {
        "field": "rent_1_74_count",
        "name": "$1 to $74 a week",
        "unit": "households",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 6
          }
        ]
      },
      {
        "field": "rent_1_74_pct",
        "name": "$1 to $74 a week: share of renting households",
        "unit": "%",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 0.24
          }
        ]
      }
    ]
  }
}

Successful Response200

application/json

About this dataset

About 5,400 suburbs and localities and 536 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 weekly rent paid by renting households on 10 August 2021, for every suburb and council area, as counts in rent bands and the median, and the type of landlord they rent from: a real estate agent, a private person, a state housing authority, a community housing provider or another landlord.

What it shows

Renting households by weekly rent band and by landlord type, each as a count and as a share of all renting households, plus the total renting households and the median weekly rent in dollars. Counts and shares are separate fields (for example rent_450_549_count and rent_450_549_pct).

Why use it

Rent paid by sitting tenants is a different number from asking rents on new listings: it shows what the whole renting population pays, including long leases and below-market public and community housing. Use it to judge rental affordability, to see how much of a suburb's rental stock is social housing, to compare paid rents with today's advertised rents, or to add a renter profile to a suburb report. For today's asking rents see the market endpoints.

How it is built

The base is occupied private dwellings being rented. The median is over renting households that stated their rent. Rents are as paid in August 2021 and are not adjusted for inflation or for later rises. Areas with fewer than 20 renting households are left out, median included. 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_renting_households` Renting households	households	Occupied private dwellings being rented, the base for every share.
`rent_1_74_count` $1 to $74 a week	households	Number of renting households in the area paying: $1 to $74 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_1_74_pct` $1 to $74 a week: share of renting households	%	$1 to $74 a week as a percent of all renting households in the area.
`rent_75_99_count` $75 to $99 a week	households	Number of renting households in the area paying: $75 to $99 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_75_99_pct` $75 to $99 a week: share of renting households	%	$75 to $99 a week as a percent of all renting households in the area.
`rent_100_149_count` $100 to $149 a week	households	Number of renting households in the area paying: $100 to $149 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_100_149_pct` $100 to $149 a week: share of renting households	%	$100 to $149 a week as a percent of all renting households in the area.
`rent_150_199_count` $150 to $199 a week	households	Number of renting households in the area paying: $150 to $199 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_150_199_pct` $150 to $199 a week: share of renting households	%	$150 to $199 a week as a percent of all renting households in the area.
`rent_200_224_count` $200 to $224 a week	households	Number of renting households in the area paying: $200 to $224 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_200_224_pct` $200 to $224 a week: share of renting households	%	$200 to $224 a week as a percent of all renting households in the area.
`rent_225_274_count` $225 to $274 a week	households	Number of renting households in the area paying: $225 to $274 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_225_274_pct` $225 to $274 a week: share of renting households	%	$225 to $274 a week as a percent of all renting households in the area.
`rent_275_349_count` $275 to $349 a week	households	Number of renting households in the area paying: $275 to $349 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_275_349_pct` $275 to $349 a week: share of renting households	%	$275 to $349 a week as a percent of all renting households in the area.
`rent_350_449_count` $350 to $449 a week	households	Number of renting households in the area paying: $350 to $449 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_350_449_pct` $350 to $449 a week: share of renting households	%	$350 to $449 a week as a percent of all renting households in the area.
`rent_450_549_count` $450 to $549 a week	households	Number of renting households in the area paying: $450 to $549 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_450_549_pct` $450 to $549 a week: share of renting households	%	$450 to $549 a week as a percent of all renting households in the area.
`rent_550_649_count` $550 to $649 a week	households	Number of renting households in the area paying: $550 to $649 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_550_649_pct` $550 to $649 a week: share of renting households	%	$550 to $649 a week as a percent of all renting households in the area.
`rent_650_749_count` $650 to $749 a week	households	Number of renting households in the area paying: $650 to $749 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_650_749_pct` $650 to $749 a week: share of renting households	%	$650 to $749 a week as a percent of all renting households in the area.
`rent_750_849_count` $750 to $849 a week	households	Number of renting households in the area paying: $750 to $849 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_750_849_pct` $750 to $849 a week: share of renting households	%	$750 to $849 a week as a percent of all renting households in the area.
`rent_850_949_count` $850 to $949 a week	households	Number of renting households in the area paying: $850 to $949 a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_850_949_pct` $850 to $949 a week: share of renting households	%	$850 to $949 a week as a percent of all renting households in the area.
`rent_950_plus_count` $950 or more a week	households	Number of renting households in the area paying: $950 or more a week (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_950_plus_pct` $950 or more a week: share of renting households	%	$950 or more a week as a percent of all renting households in the area.
`rent_not_stated_count` Rent not stated	households	Number of renting households in the area paying: Rent not stated (2021 snapshot). Small counts are lightly randomised for privacy.
`rent_not_stated_pct` Rent not stated: share of renting households	%	Rent not stated as a percent of all renting households in the area.
`landlord_real_estate_agent_count` Landlord is a real estate agent	households	Number of renting households in the area paying: Landlord is a real estate agent (2021 snapshot). Small counts are lightly randomised for privacy.
`landlord_real_estate_agent_pct` Landlord is a real estate agent: share of renting households	%	Landlord is a real estate agent as a percent of all renting households in the area.
`landlord_private_person_count` Landlord is a person not in the same household	households	Number of renting households in the area paying: Landlord is a person not in the same household (2021 snapshot). Small counts are lightly randomised for privacy.
`landlord_private_person_pct` Landlord is a person not in the same household: share of renting households	%	Landlord is a person not in the same household as a percent of all renting households in the area.
`landlord_state_housing_count` Landlord is a state or territory housing authority	households	Number of renting households in the area paying: Landlord is a state or territory housing authority (2021 snapshot). Small counts are lightly randomised for privacy.
`landlord_state_housing_pct` Landlord is a state or territory housing authority: share of renting households	%	Landlord is a state or territory housing authority as a percent of all renting households in the area.
`landlord_community_housing_count` Landlord is a community housing provider	households	Number of renting households in the area paying: Landlord is a community housing provider (2021 snapshot). Small counts are lightly randomised for privacy.
`landlord_community_housing_pct` Landlord is a community housing provider: share of renting households	%	Landlord is a community housing provider as a percent of all renting households in the area.
`landlord_other_count` Other landlord type	households	Number of renting households in the area paying: Other landlord type (2021 snapshot). Small counts are lightly randomised for privacy.
`landlord_other_pct` Other landlord type: share of renting households	%	Other landlord type as a percent of all renting households in the area.
`landlord_not_stated_count` Landlord type not stated	households	Number of renting households in the area paying: Landlord type not stated (2021 snapshot). Small counts are lightly randomised for privacy.
`landlord_not_stated_pct` Landlord type not stated: share of renting households	%	Landlord type not stated as a percent of all renting households in the area.
`median_rent_weekly` Median weekly rent paid	AUD per week	Median weekly rent paid by renting households in the area, in dollars (2021 snapshot, not inflation-adjusted).