Tenure by mesh block — owned, mortgaged, rented within 1 km (by gnaf_id)
/v1/properties/{gnaf_id}/mesh-blocks/tenure20¢ per callWho owns and who rents here? For every mesh block around the property: shares of homes owned outright, mortgaged and rented in the surrounding area, the median mortgage repayment, the share of properties ever listed for rent, and rent assistance recipients in the postcode.
One entry per mesh block within 1,000 m of the property under mesh_blocks, nearest first, each with its mb_code, distance_m, population and dwellings. Blocks across suburb lines are included. Values only — the polygons come from /properties/{gnaf_id}/context/mesh-blocks.
Every field carries provenance — measured (at this block), measured_wider_area (measured for the SA1 or postcode and repeated on every block in it), estimate (our model) or not_recorded (not labelled yet) — plus how, one sentence on how the number was arrived at (empty when not_recorded).
Authorization
Request
The only values you send. Fields under Responses below are what comes back — you never pass those.
Path parameters
gnaf_idstringrequiredQuery parameters
Responses
Successful Response
gnaf_idstringalways returnedThe property, as given.
suburbstringmay be nullThe property's suburb (SAL). Blocks across suburb lines are included.
statestringmay be nullState / Territory abbreviation of the property.
radius_mintegeralways returnedRadius around the property, in metres (1,000).
topicstringalways returnedWhich topic this answers.
questionstringalways returnedThe question this topic answers.
betabooleanalways returned`true` when the figures behind this topic have not been validated against an independent source yet.
beta_noticestringmay be nullWhat is unvalidated, on beta topics only.
block_countintegeralways returnedHow many mesh blocks are in `mesh_blocks`.
mesh_blocksarray of PropertyMbTopicBlockalways returnedOne entry per mesh block within `radius_m`, nearest first.
notestringalways returnedHow to read `provenance`.
About this data
What this is
Who owns and who rents around one address, block by block: for each mesh block within 1 km, the shares of homes owned outright, mortgaged and rented in the surrounding SA1, the median mortgage repayment, the share of properties ever listed for rent, and rent assistance recipients in the postcode.
What people use it for
- Buyers: gauge how settled a street is: owner-occupiers or a rental pocket.
- Investors: find blocks with strong rental demand, or avoid ones already heavy with rentals.
- Agents: target owner-occupier streets for appraisal campaigns.
Coverage
Mesh blocks nationwide (about 368,000). The 1 km radius crosses suburb lines. A field is null where we hold nothing for that block.
Tips
Most fields here are measured for the SA1 or postcode and repeated on each block in it. Check provenance before quoting a field. Whole suburb: /v1/suburbs/{suburb_name}/mesh-blocks/tenure. Polygons: /v1/properties/{gnaf_id}/context/mesh-blocks, joined on mb_code.
/v1/properties/{gnaf_id}/mesh-blocks/tenurecurl --request GET \
--url 'https://api.microburbs.com.au/v1/properties/GANSW704074813/mesh-blocks/tenure' \
--header 'Authorization: Bearer test'{
"data": {
"gnaf_id": "GANSW704074813",
"suburb": "Belmont North",
"state": "NSW",
"radius_m": 1000,
"topic": "tenure",
"question": "Who owns and who rents here?",
"beta": false,
"block_count": 102,
"mesh_blocks": [
{
"mb_code": "10434270000",
"population": 124,
"dwellings": 46,
"fields": {
"owned_outright_pct": {
"value": 26.06,
"unit": "% of owned, mortgaged or rented homes",
"measured_at": "sa1",
"label": "Homes owned outright, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"mortgaged_pct": {
"value": 49.3,
"unit": "% of owned, mortgaged or rented homes",
"measured_at": "sa1",
"label": "Homes owned with a mortgage, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"rented_pct": {
"value": 24.65,
"unit": "% of owned, mortgaged or rented homes",
"measured_at": "sa1",
"label": "Homes rented, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"area_median_mortgage_monthly": {
"value": 1890,
"unit": "AUD per month",
"measured_at": "sa1",
"label": "Median monthly mortgage repayment, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"ever_rented_pct": {
"value": 25,
"unit": "% of properties",
"label": "Properties on this block ever listed for rent",
"provenance": "not_recorded",
"how": ""
},
"rent_assistance_recipients_postcode": {
"value": 1440,
"unit": "people",
"measured_at": "postcode",
"label": "People receiving Commonwealth Rent Assistance, whole postcode",
"provenance": "measured_wider_area",
"how": "measured for the postcode, repeated on this Microburb"
}
},
"distance_m": 0
},
{
"mb_code": "10434330000",
"population": 89,
"dwellings": 32,
"fields": {
"owned_outright_pct": {
"value": 26.06,
"unit": "% of owned, mortgaged or rented homes",
"measured_at": "sa1",
"label": "Homes owned outright, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"mortgaged_pct": {
"value": 49.3,
"unit": "% of owned, mortgaged or rented homes",
"measured_at": "sa1",
"label": "Homes owned with a mortgage, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"rented_pct": {
"value": 24.65,
"unit": "% of owned, mortgaged or rented homes",
"measured_at": "sa1",
"label": "Homes rented, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"area_median_mortgage_monthly": {
"value": 1890,
"unit": "AUD per month",
"measured_at": "sa1",
"label": "Median monthly mortgage repayment, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"ever_rented_pct": {
"value": 14.81,
"unit": "% of properties",
"label": "Properties on this block ever listed for rent",
"provenance": "not_recorded",
"how": ""
},
"rent_assistance_recipients_postcode": {
"value": 1440,
"unit": "people",
"measured_at": "postcode",
"label": "People receiving Commonwealth Rent Assistance, whole postcode",
"provenance": "measured_wider_area",
"how": "measured for the postcode, repeated on this Microburb"
}
},
"distance_m": 15
},
{
"mb_code": "10434440000",
"population": 99,
"dwellings": 34,
"fields": {
"owned_outright_pct": {
"value": 26.06,
"unit": "% of owned, mortgaged or rented homes",
"measured_at": "sa1",
"label": "Homes owned outright, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"mortgaged_pct": {
"value": 49.3,
"unit": "% of owned, mortgaged or rented homes",
"measured_at": "sa1",
"label": "Homes owned with a mortgage, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"rented_pct": {
"value": 24.65,
"unit": "% of owned, mortgaged or rented homes",
"measured_at": "sa1",
"label": "Homes rented, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"area_median_mortgage_monthly": {
"value": 1890,
"unit": "AUD per month",
"measured_at": "sa1",
"label": "Median monthly mortgage repayment, surrounding area",
"provenance": "measured_wider_area",
"how": "measured for the surrounding area (SA1), repeated on this Microburb"
},
"ever_rented_pct": {
"value": 10.26,
"unit": "% of properties",
"label": "Properties on this block ever listed for rent",
"provenance": "not_recorded",
"how": ""
},
"rent_assistance_recipients_postcode": {
"value": 1440,
"unit": "people",
"measured_at": "postcode",
"label": "People receiving Commonwealth Rent Assistance, whole postcode",
"provenance": "measured_wider_area",
"how": "measured for the postcode, repeated on this Microburb"
}
},
"distance_m": 56
}
],
"note": "Each field says how its number was arrived at. An estimate is not a measurement, and a figure measured for a wider area is not a measurement of the block."
}
}