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 - Lifestyle

Transport by mesh block — stops, stations, commuting (by suburb)

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

How do you get around from here? For every mesh block in the suburb: distance to the nearest bus stop, train station and tram stop, bus stops within 320 m, and how many workers commute by public transport.

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/transport
cURL
curl --request GET \
  --url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/mesh-blocks/transport' \
  --header 'Authorization: Bearer test'
Example Responses
{
  "data": {
    "suburb": "Belmont North",
    "state": "NSW",
    "topic": "transport",
    "question": "How do you get around from here?",
    "beta": false,
    "block_count": 85,
    "mesh_blocks": [
      {
        "mb_code": "10434270000",
        "population": 124,
        "dwellings": 46,
        "fields": {
          "bus_stop_nearest_m": {
            "value": 533.64,
            "label": "Nearest bus stop",
            "unit": "metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "train_station_nearest_m": {
            "value": 8187.3,
            "label": "Nearest train station",
            "unit": "metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "tram_stop_nearest_m": {
            "value": 127623.22,
            "label": "Nearest tram stop",
            "unit": "metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "bus_stops_within_320m": {
            "value": 0,
            "label": "Bus stops within 320 m",
            "unit": "count",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "public_transport_to_work_pct": {
            "value": 1.55,
            "label": "Workers who commute by public transport",
            "unit": "% of workers",
            "provenance": "estimate",
            "how": "our estimate for this Microburb"
          },
          "listed_close_to_public_transport_pct": {
            "value": 0,
            "label": "Listings that describe themselves as close to public transport",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          }
        }
      },
      {
        "mb_code": "11205004200",
        "population": 189,
        "dwellings": 63,
        "fields": {
          "bus_stop_nearest_m": {
            "value": 804.56,
            "label": "Nearest bus stop",
            "unit": "metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "train_station_nearest_m": {
            "value": 8846.56,
            "label": "Nearest train station",
            "unit": "metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "tram_stop_nearest_m": {
            "value": 126641.51,
            "label": "Nearest tram stop",
            "unit": "metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "bus_stops_within_320m": {
            "value": 0,
            "label": "Bus stops within 320 m",
            "unit": "count",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "public_transport_to_work_pct": {
            "value": 1.46,
            "label": "Workers who commute by public transport",
            "unit": "% of workers",
            "provenance": "estimate",
            "how": "our estimate for this Microburb"
          },
          "listed_close_to_public_transport_pct": {
            "value": 66.67,
            "label": "Listings that describe themselves as close to public transport",
            "unit": "% of listings",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          }
        }
      },
      {
        "mb_code": "10436570000",
        "population": 169,
        "dwellings": 64,
        "fields": {
          "bus_stop_nearest_m": {
            "value": 902.87,
            "label": "Nearest bus stop",
            "unit": "metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "train_station_nearest_m": {
            "value": 7450.37,
            "label": "Nearest train station",
            "unit": "metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "tram_stop_nearest_m": {
            "value": 127724.14,
            "label": "Nearest tram stop",
            "unit": "metres",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "bus_stops_within_320m": {
            "value": 0,
            "label": "Bus stops within 320 m",
            "unit": "count",
            "provenance": "measured",
            "measured_at": "mesh_block",
            "how": "measured at this level"
          },
          "public_transport_to_work_pct": {
            "value": 1.75,
            "label": "Workers who commute by public transport",
            "unit": "% of workers",
            "provenance": "estimate",
            "how": "our estimate for this Microburb"
          },
          "listed_close_to_public_transport_pct": {
            "value": 36.36,
            "label": "Listings that describe themselves as close to public transport",
            "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