Projected voting profile
/v1/suburbs/{suburb_name}/demographics/voting10¢ per callProjected first-preference shares per party, aggregated across the suburb's microburbs (booth-derived model — not an actual vote).
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: 10¢ 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.
n_microburbsintegeralways returnedMicroburbs in the aggregate.
projectionstringalways returnedWhat the projection represents (and its provenance).
winnerobjectalways returnedOne party's projected first-preference share.
runner_upobjectalways returnedOne party's projected first-preference share.
margin_pctnumberalways returnedWinner-minus-runner-up margin (pp).
leanstringalways returnedStrong <party> (≥15pp) / <party> lean (≥5pp) / Marginal.
partiesarray of PartyResultalways returnedAll parties polling ≥0.5%, descending.
/v1/suburbs/{suburb_name}/demographics/votingcurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/demographics/voting' \
--header 'Authorization: Bearer test'{
"data": {
"lean": "Labor lean",
"margin_pct": 6.7,
"n_microburbs": 85,
"parties": [
{
"label": "Labor",
"party": "ALP",
"pct": 38.2
},
{
"label": "Liberal",
"party": "LIB",
"pct": 31.5
},
{
"label": "Greens",
"party": "GRN",
"pct": 11.3
}
],
"projection": "Federal election held May 2026 (projected — not an actual vote)",
"runner_up": {
"label": "Liberal",
"party": "LIB",
"pct": 31.5
},
"suburb": "Belmont North",
"winner": {
"label": "Labor",
"party": "ALP",
"pct": 38.2
}
}
}