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

Condition by mesh block — renovation signals from listings (by suburb)

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

What condition are the homes in? For every mesh block in the suburb, how its listings describe the homes: renovated, updated kitchens and bathrooms, renovation potential, original features, air conditioning, and how many listings the shares are read from.

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/condition
cURL
curl --request GET \
  --url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/mesh-blocks/condition' \
  --header 'Authorization: Bearer test'
Example Responses
{
  "data": {
    "suburb": "Belmont North",
    "state": "NSW",
    "topic": "condition",
    "question": "What condition are the homes in?",
    "beta": false,
    "block_count": 85,
    "mesh_blocks": [
      {
        "mb_code": "10434270000",
        "population": 124,
        "dwellings": 46,
        "fields": {
          "listings_read": {
            "value": 4,
            "label": "Listings on this block the condition shares below are read from",
            "unit": "count",
            "provenance": "not_recorded",
            "how": "provenance not recorded"
          },
          "renovated_pct": {
            "value": 0,
            "label": "Described as renovated",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "fully_renovated_pct": {
            "value": 0,
            "label": "Described as fully renovated",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "renovated_kitchen_pct": {
            "value": 0,
            "label": "Renovated kitchen",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "updated_kitchen_pct": {
            "value": 0,
            "label": "Updated kitchen",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "modern_kitchen_pct": {
            "value": 0,
            "label": "Modern kitchen",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "updated_bathroom_pct": {
            "value": 0,
            "label": "Updated bathroom",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "renovation_potential_pct": {
            "value": 0,
            "label": "Described as having renovation potential",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "original_features_pct": {
            "value": 0,
            "label": "Described as having original features",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "air_conditioning_pct": {
            "value": 50,
            "label": "Air conditioning",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          }
        }
      },
      {
        "mb_code": "11205004200",
        "population": 189,
        "dwellings": 63,
        "fields": {
          "listings_read": {
            "value": 3,
            "label": "Listings on this block the condition shares below are read from",
            "unit": "count",
            "provenance": "not_recorded",
            "how": "provenance not recorded"
          },
          "renovated_pct": {
            "value": 0,
            "label": "Described as renovated",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "fully_renovated_pct": {
            "value": 0,
            "label": "Described as fully renovated",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "renovated_kitchen_pct": {
            "value": 0,
            "label": "Renovated kitchen",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "updated_kitchen_pct": {
            "value": 0,
            "label": "Updated kitchen",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "modern_kitchen_pct": {
            "value": 0,
            "label": "Modern kitchen",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "updated_bathroom_pct": {
            "value": 0,
            "label": "Updated bathroom",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "renovation_potential_pct": {
            "value": 0,
            "label": "Described as having renovation potential",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "original_features_pct": {
            "value": 0,
            "label": "Described as having original features",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "air_conditioning_pct": {
            "value": 66.67,
            "label": "Air conditioning",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          }
        }
      },
      {
        "mb_code": "10436570000",
        "population": 169,
        "dwellings": 64,
        "fields": {
          "listings_read": {
            "value": 11,
            "label": "Listings on this block the condition shares below are read from",
            "unit": "count",
            "provenance": "not_recorded",
            "how": "provenance not recorded"
          },
          "renovated_pct": {
            "value": 0,
            "label": "Described as renovated",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "fully_renovated_pct": {
            "value": 0,
            "label": "Described as fully renovated",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "renovated_kitchen_pct": {
            "value": 0,
            "label": "Renovated kitchen",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "updated_kitchen_pct": {
            "value": 9.09,
            "label": "Updated kitchen",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "modern_kitchen_pct": {
            "value": 9.09,
            "label": "Modern kitchen",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "updated_bathroom_pct": {
            "value": 0,
            "label": "Updated bathroom",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "renovation_potential_pct": {
            "value": 0,
            "label": "Described as having renovation potential",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "original_features_pct": {
            "value": 0,
            "label": "Described as having original features",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "air_conditioning_pct": {
            "value": 54.55,
            "label": "Air conditioning",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          }
        }
      }
    ],
    "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