Parcels by mesh block — lot sizes and shapes within 1 km (by gnaf_id) (beta)
/v1/properties/{gnaf_id}/mesh-blocks/parcels20¢ per callBeta. The figures behind this topic have not been validated against an independent source, so it is not sold at the same confidence as the other mesh-block topics. Every response says beta: true and carries a beta_notice.
How big are the blocks of land? For every mesh block around the property: median and spread of lot sizes, lot shape, floor space ratio, the minimum lot size under the planning rules, and the number of land parcels.
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
Land parcels around one address, block by block (beta): for each mesh block within 1 km, the median lot size and its spread, lot shape, floor space ratio, the minimum lot size under the planning rules, and the number of parcels.
What people use it for
- Developers: find blocks where lots are large relative to the minimum lot size, a first screen for subdivision.
- Buyers: compare a home's land with the typical lot on surrounding blocks.
- Planners and analysts: map lot patterns across a neighbourhood.
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
This topic is beta; lot sizes are measured, but the topic has not been validated against an independent source yet. For the property's own land area use /v1/properties/{gnaf_id}/basics/land-area-sqm. Check provenance before quoting a field. Whole suburb: /v1/suburbs/{suburb_name}/mesh-blocks/parcels. Polygons: /v1/properties/{gnaf_id}/context/mesh-blocks, joined on mb_code.
/v1/properties/{gnaf_id}/mesh-blocks/parcelscurl --request GET \
--url 'https://api.microburbs.com.au/v1/properties/GANSW704074813/mesh-blocks/parcels' \
--header 'Authorization: Bearer test'{
"data": {
"gnaf_id": "GANSW704074813",
"suburb": "Belmont North",
"state": "NSW",
"radius_m": 1000,
"topic": "parcels",
"question": "How big are the blocks of land?",
"beta": true,
"beta_notice": "Beta: this topic has not been validated against an independent source yet. Check each field's provenance before presenting a figure as a measurement.",
"block_count": 102,
"mesh_blocks": [
{
"mb_code": "10434270000",
"population": 124,
"dwellings": 46,
"fields": {
"lot_size_median_sqm": {
"value": 640.24,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Median lot size",
"provenance": "measured",
"how": "measured at this level"
},
"lot_size_p25_sqm": {
"value": 612.97,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Lot size, 25th percentile",
"provenance": "measured",
"how": "measured at this level"
},
"lot_size_p75_sqm": {
"value": 671.84,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Lot size, 75th percentile",
"provenance": "measured",
"how": "measured at this level"
},
"lot_compactness_mean": {
"value": 0.66,
"unit": "index 0-1",
"measured_at": "mesh_block",
"label": "How square the lots are (1 = a perfect square)",
"provenance": "measured",
"how": "measured at this level"
},
"floor_space_ratio_mean": {
"unit": "ratio",
"measured_at": "mesh_block",
"label": "Average floor space ratio",
"provenance": "measured",
"how": "measured at this level"
},
"min_lot_size_rule_sqm": {
"value": 450,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Minimum lot size under the planning rules",
"provenance": "measured",
"how": "measured at this level"
},
"parcels": {
"value": 49,
"unit": "count",
"label": "Land parcels on this block",
"provenance": "not_recorded",
"how": ""
}
},
"distance_m": 0
},
{
"mb_code": "10434330000",
"population": 89,
"dwellings": 32,
"fields": {
"lot_size_median_sqm": {
"value": 618.15,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Median lot size",
"provenance": "measured",
"how": "measured at this level"
},
"lot_size_p25_sqm": {
"value": 613.81,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Lot size, 25th percentile",
"provenance": "measured",
"how": "measured at this level"
},
"lot_size_p75_sqm": {
"value": 673.41,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Lot size, 75th percentile",
"provenance": "measured",
"how": "measured at this level"
},
"lot_compactness_mean": {
"value": 0.67,
"unit": "index 0-1",
"measured_at": "mesh_block",
"label": "How square the lots are (1 = a perfect square)",
"provenance": "measured",
"how": "measured at this level"
},
"floor_space_ratio_mean": {
"unit": "ratio",
"measured_at": "mesh_block",
"label": "Average floor space ratio",
"provenance": "measured",
"how": "measured at this level"
},
"min_lot_size_rule_sqm": {
"value": 450,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Minimum lot size under the planning rules",
"provenance": "measured",
"how": "measured at this level"
},
"parcels": {
"value": 33,
"unit": "count",
"label": "Land parcels on this block",
"provenance": "not_recorded",
"how": ""
}
},
"distance_m": 15
},
{
"mb_code": "10434440000",
"population": 99,
"dwellings": 34,
"fields": {
"lot_size_median_sqm": {
"value": 1004.91,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Median lot size",
"provenance": "measured",
"how": "measured at this level"
},
"lot_size_p25_sqm": {
"value": 724.91,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Lot size, 25th percentile",
"provenance": "measured",
"how": "measured at this level"
},
"lot_size_p75_sqm": {
"value": 1518.1,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Lot size, 75th percentile",
"provenance": "measured",
"how": "measured at this level"
},
"lot_compactness_mean": {
"value": 0.6,
"unit": "index 0-1",
"measured_at": "mesh_block",
"label": "How square the lots are (1 = a perfect square)",
"provenance": "measured",
"how": "measured at this level"
},
"floor_space_ratio_mean": {
"unit": "ratio",
"measured_at": "mesh_block",
"label": "Average floor space ratio",
"provenance": "measured",
"how": "measured at this level"
},
"min_lot_size_rule_sqm": {
"value": 450,
"unit": "square metres",
"measured_at": "mesh_block",
"label": "Minimum lot size under the planning rules",
"provenance": "measured",
"how": "measured at this level"
},
"parcels": {
"value": 43,
"unit": "count",
"label": "Land parcels on this block",
"provenance": "not_recorded",
"how": ""
}
},
"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."
}
}