Microburbs
Microburbs API
Live sandbox. Send any request below against one sample suburb and property — no signup needed. For full coverage, create an API key.
Classic docs
Microburbs Property Data API
Suburb - Development

Parcels by mesh block — lot sizes and shapes (by suburb) (beta)

GET/v1/suburbs/{suburb_name}/mesh-blocks/parcels20¢ per call

Beta. 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 in the suburb: 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 in the suburb under mesh_blocks, each with its mb_code, population and dwellings. Values only — the matching polygons come from /shapes/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 — plus how, one sentence on how the number was arrived at.

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: 20¢ per call.

Authorization

Request

The only values you send. Fields under Responses below are what comes back — you never pass those.

Path parameters

suburb_namestringrequired

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.

Query parameters

None — this endpoint accepts no query parameters. Call the path above with your bearer token and nothing else.

Responses

Successful Response

application/json
SuburbMbTopicfields returned to you
suburbstringalways returned

Suburb (SAL) name, as resolved.

statestringmay be null

State / Territory abbreviation.

topicstringalways returned

Which topic this answers.

questionstringalways returned

The 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 null

What is unvalidated, on beta topics only.

block_countintegeralways returned

How many mesh blocks are in `mesh_blocks`.

mesh_blocksarray of MbTopicBlockalways returned

One entry per mesh block in the suburb, ordered by `mb_code`.

notestringalways returned

How to read `provenance`.

GET/v1/suburbs/{suburb_name}/mesh-blocks/parcels
cURL
curl --request GET \
  --url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/mesh-blocks/parcels' \
  --header 'Authorization: Bearer test'
Example Responses
{
  "data": {
    "suburb": "Belmont North",
    "state": "NSW",
    "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": 85,
    "mesh_blocks": [
      {
        "mb_code": "10434270000",
        "population": 124,
        "dwellings": 46,
        "fields": {
          "lot_size_median_sqm": {
            "value": 640.24,
            "label": "Median lot size",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "lot_size_p25_sqm": {
            "value": 612.97,
            "label": "Lot size, 25th percentile",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "lot_size_p75_sqm": {
            "value": 671.84,
            "label": "Lot size, 75th percentile",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "lot_compactness_mean": {
            "value": 0.66,
            "label": "How square the lots are (1 = a perfect square)",
            "unit": "index 0-1",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "floor_space_ratio_mean": {
            "label": "Average floor space ratio",
            "unit": "ratio",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "min_lot_size_rule_sqm": {
            "value": 450,
            "label": "Minimum lot size under the planning rules",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "parcels": {
            "value": 49,
            "label": "Land parcels on this block",
            "unit": "count",
            "provenance": "not_recorded",
            "how": "provenance not recorded"
          }
        }
      },
      {
        "mb_code": "11205004200",
        "population": 189,
        "dwellings": 63,
        "fields": {
          "lot_size_median_sqm": {
            "value": 656.31,
            "label": "Median lot size",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "lot_size_p25_sqm": {
            "value": 504.61,
            "label": "Lot size, 25th percentile",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "lot_size_p75_sqm": {
            "value": 755.15,
            "label": "Lot size, 75th percentile",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "lot_compactness_mean": {
            "value": 0.7,
            "label": "How square the lots are (1 = a perfect square)",
            "unit": "index 0-1",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "floor_space_ratio_mean": {
            "label": "Average floor space ratio",
            "unit": "ratio",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "min_lot_size_rule_sqm": {
            "value": 450,
            "label": "Minimum lot size under the planning rules",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "parcels": {
            "value": 69,
            "label": "Land parcels on this block",
            "unit": "count",
            "provenance": "not_recorded",
            "how": "provenance not recorded"
          }
        }
      },
      {
        "mb_code": "10436570000",
        "population": 169,
        "dwellings": 64,
        "fields": {
          "lot_size_median_sqm": {
            "value": 626.63,
            "label": "Median lot size",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "lot_size_p25_sqm": {
            "value": 595.42,
            "label": "Lot size, 25th percentile",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "lot_size_p75_sqm": {
            "value": 718.22,
            "label": "Lot size, 75th percentile",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "lot_compactness_mean": {
            "value": 0.69,
            "label": "How square the lots are (1 = a perfect square)",
            "unit": "index 0-1",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "floor_space_ratio_mean": {
            "label": "Average floor space ratio",
            "unit": "ratio",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "min_lot_size_rule_sqm": {
            "value": 450,
            "label": "Minimum lot size under the planning rules",
            "unit": "square metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "parcels": {
            "value": 62,
            "label": "Land parcels on this block",
            "unit": "count",
            "provenance": "not_recorded",
            "how": "provenance not recorded"
          }
        }
      }
    ],
    "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."
  }
}
Successful Response200
application/json