Nearby schools
/v1/suburbs/{suburb_name}/schools/nearby5¢ per callSchools serving / near the suburb, with rank + attendance data.
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: 5¢ 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
area_namestringalways returnedSuburb (SAL) name.
area_levelstringalways returnedAlways 'suburb'.
idnumbermay be nullStable numeric identifier for the school, for joining these rows across calls. Delivered as a number but it is an identifier — do not do arithmetic on it or compare its magnitude.
namestringmay be nullThe school's full name, as officially registered.
school_level_typestringmay be nullWhich years the school covers — 'Primary', 'Secondary', or 'Combined' for a school spanning both.
school_sector_typestringmay be nullWho runs the school — 'Public' (government), 'Private', or 'Non-Government' (the wider category including Catholic and independent schools). Fee-paying status is implied, not stated.
naplan_ranknumbermay be nullThe school's academic standing on national NAPLAN testing, as a percentile between 0 and 1 where higher is better — 0.63 puts the school ahead of about 63% of schools, i.e. in roughly the top 40%. A fraction, not a percentage and not a raw test score. Null when the school has no published NAPLAN standing.
socioeconomic_ranknumbermay be nullHow advantaged the school's community is, as a percentile between 0 and 1 where higher means more advantaged — 0.17 sits near the bottom of the national distribution. Measures the intake's socio-economic background, not teaching quality, and it is separate from `naplan_rank`: schools rank high on one and low on the other.
attendance_ratenumbermay be nullShare of school days actually attended by the average enrolled student, as a fraction between 0 and 1 — 0.89 means 89%. Multiply by 100 to display. Most schools cluster in the high 0.8s to low 0.9s, so small differences matter more than the range suggests.
genderstringmay be nullWho the school enrols — 'coed', 'girls' (girls only) or 'boys' (boys only).
boysnumbermay be nullNumber of male students enrolled — a headcount, despite the numeric type. Add to `girls` for total enrolment, which is the best available proxy for school size.
girlsnumbermay be nullNumber of female students enrolled — a headcount. See `boys`.
/v1/suburbs/{suburb_name}/schools/nearbycurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/schools/nearby' \
--header 'Authorization: Bearer test'{
"data": [
{
"area_name": "Belmont North",
"area_level": "suburb",
"id": 42002,
"name": "Belmont North Public School",
"school_level_type": "Primary",
"school_sector_type": "Public",
"naplan_rank": 0.6282832390938133,
"socioeconomic_rank": 0.17342543077837194,
"attendance_rate": 0.89,
"gender": "coed",
"boys": 90,
"girls": 82
},
{
"area_name": "Belmont North",
"area_level": "suburb",
"id": 44016,
"name": "Belmont Christian College",
"school_level_type": "Combined",
"school_sector_type": "Private",
"naplan_rank": 0.7306959133962242,
"socioeconomic_rank": 0.7843137254901961,
"attendance_rate": 0.88,
"gender": "coed",
"boys": 385,
"girls": 350
}
]
}