Free sandbox: try any request below on the sample suburbs, no signup. For every suburb, create an API key.

Microburbs Property Data API

Property - Schools

School catchments at this address

GET/v1/properties/{gnaf_id}/schools/catchments3¢ per call

The government schools this address is zoned for (primary, secondary), from the current catchment maps for every state and territory. Not found when the address is unknown or sits inside no catchment we hold. Full description: /v1/datasets/school-catchments.

Authorization

Bearer tokentest

Sandbox key test works for the allowlisted GNAF + SAL — no signup.

Request

The only values you send. Fields under Responses below are what comes back — you never pass those.

Path parameters

gnaf_idstringrequired

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

list[SchoolCatchment]fields returned to you

Array of:

school_namestringmay be null

Name of the school the address is zoned for.

school_idintegermay be null

School id, as in /schools/nearby; null when the zone could not be tied to a school in that list.

levelstringmay be null

primary, secondary, junior_secondary, senior_secondary or combined.

genderstringmay be null

boys or girls for single-sex schools; null if co-educational or unknown.

year_levelsstringmay be null

School years the zone serves, e.g. K-6 or 7-12; null when not published.

catchment_yearintegermay be null

School year of the catchment map.

as_ofstringmay be null

Date our copy of that map is current to (the map's year start for maps before 2024).

GET/v1/properties/{gnaf_id}/schools/catchments

cURL

curl --request GET \
  --url 'https://api.microburbs.com.au/v1/properties/GANSW704074813/schools/catchments' \
  --header 'Authorization: Bearer test'

Example Responses

Show schema

{
  "data": [
    {
      "as_of": "2026-10-02",
      "catchment_year": 2026,
      "level": "primary",
      "school_id": 42002,
      "school_name": "Belmont North Public School",
      "year_levels": "K-6"
    }
  ]
}

Successful Response200

application/json

About this dataset

Every state and territory. NSW, VIC, QLD and ACT 2026; SA 2025; TAS 2024; WA and NT 2022 maps. About 6,800 zones. Current to 2026-10-02; refreshed yearly.

What it is

The government schools a given address is guaranteed a place at, because the address sits inside the school's official catchment (also called an intake zone, school zone, local intake area or priority enrolment area). One call returns every zone the address falls in: typically one primary school and one or two secondary schools.

What it shows

For each zone: the school name, our school id (the same id the nearby-schools and school-ranking endpoints use, when we can tie the school), the level (primary, secondary, junior secondary, senior secondary or combined), whether the school is boys-only or girls-only where that is known, the year levels the zone serves, and the year of the catchment map. An address inside no catchment we hold returns not-found, and that is never charged.

Why use it

Catchment is the single biggest school-related price driver in Australian housing: the same street can sell for a large premium on one side of a zone line. Buyers, buyer's agents, agents writing listings, valuers and relocation advisers all need the answer to 'which school is this house zoned for', and until now it meant checking up to eight different state websites by hand. Pair it with the nearby-schools and school-ranking endpoints to compare the zoned school with the alternatives.

How it is built

We hold each state's current published catchment boundaries as polygons and test whether the address point falls inside each one. Boundaries are simplified to about 5 metres, so an address sitting right on a boundary line should be confirmed with the school. Catchment year differs by state: New South Wales, Victoria, Queensland and the ACT are the 2026 school year, South Australia 2025 and Tasmania 2024; Western Australia and the Northern Territory are 2022 maps, the latest we hold, so check those with the school before relying on them. A catchment guarantees enrolment; it is not a ranking, and some schools also take out-of-zone students. Government schools only; private and Catholic schools do not have catchments.

Fields

Field	Unit	Description
`school_name` School name		Name of the school the address is zoned for.
`school_id` School id		Our school id, the same one the nearby-schools and school-ranking endpoints return. Null when we could not tie the zone to a school in that list.
`level` Level		primary, secondary (years 7 to 12), junior_secondary (years 7 to 9 or 10), senior_secondary (years 10/11 to 12) or combined.
`gender` Gender		boys or girls for single-sex schools; null when the school is co-educational or we do not know.
`year_levels` Year levels		The school years the zone serves, for example K-6 or 7-12. Null when not published.
`catchment_year` Catchment year	year	The school year of the catchment map the zone comes from.