Projected voting by mesh block (by suburb)
/v1/suburbs/{suburb_name}/demographics/voting-map20¢ per callProjected winning party, runner-up and margin for every microburb (mesh
block) in the suburb at a federal election held May 2026 — a projection,
not an actual vote. The suburb-wide profile is /demographics/voting.
Values only; polygons come from /shapes/mesh-blocks.
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_namestringrequiredExact 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
Responses
Successful Response
suburbstringalways returnedCanonical SAL name.
metricstringalways returnedAlways 'projected_winning_party'.
unitstringalways returnedAlways 'percentage_points' (the margin).
definitionstringalways returnedHow the figure is derived.
n_microburbsintegeralways returnedMicroburbs with a projection.
microburbsarray of VotingMbalways returnedPer-microburb winners, by mesh-block code.
/v1/suburbs/{suburb_name}/demographics/voting-mapcurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/demographics/voting-map' \
--header 'Authorization: Bearer test'{
"data": {
"suburb": "Belmont North",
"metric": "projected_winning_party",
"unit": "percentage_points",
"definition": "Projected first-preference vote for each mesh block ('microburb', ~30-60 dwellings) at a federal election held May 2026 — a projection, not an actual vote. `winner` is the party with the highest share and `margin_pct` its lead over the runner-up, in percentage points. Compare the suburb-wide profile at /demographics/voting.",
"n_microburbs": 77,
"microburbs": [
{
"mb": "10431160000",
"street": "Floraville",
"winner": "ON",
"winner_label": "One Nation",
"winner_pct": 39.8,
"runner_up": "ALP",
"runner_up_label": "Labor",
"runner_up_pct": 28.9,
"margin_pct": 10.9
}
]
}
}