Documentation

Property API

Give it an Australian address and get back, in one JSON answer, six hazards at that location (bushfire, flood, landslide, coastal, earthquake and cyclone). Each comes with the register we hold for it, its date and how confident the answer is. In New South Wales it also gives the Valuer General’s land value for the lot on each 1 July since 2012 that the Valuer General valued it. Hazards are tested at one point: the address point, or the coordinates you send. Where we hold no register for a hazard, the answer saysunmapped (what unmapped means). Today that includes earthquake and cyclone everywhere. It runs on the same API key as the address API. It is available by arrangement while its coverage grows. A sample answer is free with any secret key.

Need a PDF for one address instead? WattleAddr Property reports are $9.90 incl. GST, or free in Western Australia, where the report reads the address point only.

Availability

The Property API is not sold self-serve yet, because its coverage is uneven across Australia. As at 3 October 2026:

Bushfire is held statewide in New South Wales, Victoria, Tasmania, the ACT and Western Australia.
Flood is partial wherever it is held. In New South Wales most councils have no flood planning map in the layer we read.
Landslide is held in parts of New South Wales and Victoria, and statewide in Tasmania. Coastal hazard is held in parts of Tasmania.
Queensland has a broad flood screening layer only, which excludes most of South East Queensland. South Australia and the Northern Territory have nothing yet.
Earthquake and cyclone are unmapped everywhere. Land values are New South Wales only.

If it covers the places you need, we can set it up for your account. Contact us with the States you work in and your expected monthly volume. Try the free sample first to see the answer shape.

Quickstart

Use a secret key from your server (create one in the console under API keys). Start with the free sample, which works with any secret key (a live key, or a test key during your account’s first 15 days):

curl -H "Authorization: Bearer YOUR_SECRET_KEY" \
https://api.wattleaddr.com.au/v1/property/sample

Then ask about a real address, with a live key on a workspace we have set up for it:

curl -G -H "Authorization: Bearer YOUR_SECRET_KEY" \
--data-urlencode "address=25 Echidna Close, Bellbird NSW 2325" \
https://api.wattleaddr.com.au/v1/property

Test keys (waddr_sk_test_…) always get the sample back from /v1/property, whatever you ask for, marked "test": true, and are never billed. That lets you build against the real response shape before you buy.

Request

Parameter	What it is
`address`	A full street address, with the number (and the unit, for a unit). A street or a suburb on its own is refused, unbilled, with `not_a_property`.
`lat`, `lon`	Instead of `address`: a point in decimal degrees, latitude first and negative in Australia. The answer is for that point.

Response

Field	What it holds
`address`	The address we matched, its G-NAF id and how well it matched. Check it is the property you meant.
`jurisdiction`	The state or territory of the point.
`hazards[]`	One entry per hazard: `status` is `present`, `absent` or `unmapped`; `confidence` is `confirmed`, `derived`, `estimated` or `unresolved`; `findings` name the register, its category and date. `absent` is a finding only where a register covers the point, and it is never `confirmed`: it is tested at the address point, and part of the lot may still be inside a mapped area. `unmapped` means no register we hold covers it, which is not the same as safe. In New South Wales, flood is mapped only where a council has put its flood planning map into the statewide layer, so many NSW addresses get `unmapped` flood. The `basis` says where to ask.
`hazards[].wattleaddr_rating`	Our normalisation of the register’s categories so hazards can be compared across states, not the publisher’s own category (which is in `findings`). See `rating_note` in the answer.
`unmapped`	The hazards with no register here, listed again so you cannot miss them.
`land_value`	NSW only. `state: "present"` with `latest` and `history` (each 1 July the Valuer General valued the lot, in dollars), the lot, the Valuer General property id and the source; or `state: "unavailable"` with the reason. A land value is given only where the lot is exactly one Valuer General property, valued in the newest year we hold. So none is given for another state, a strata or community scheme, a property made of several lots or of part of a lot, a lot shared by several properties, or a lot whose property no longer exists.
`attribution`, `licences`, `licences_note`	The notices and licences for exactly the data in this answer. Keep them with the data wherever you show it.
`billing.property_key`, `billed`	The property this answer was billed for, and whether this call was billed (`false` for a repeat within the hour).
`test`, `sample`	Present and `true` on a test key’s answer and on the sample.

Land value is not what a property is worth. It is the Valuer General’s value of the land alone, as at 1 July, as if nothing were built on it; councils rate on it, and Revenue NSW uses it, averaged over up to three years, for land tax. It is not a sale price, a valuation or a forecast, and the answer says so in land_value.note. Show that note wherever you show the figure.

Headers on a live call: x-wattleaddr-property-quota-limit (included lookups this period) and x-wattleaddr-property-quota-remaining (included lookups left. At 0, lookups continue as overage until five times the included number).

Example answer

The sample property’s answer, as /v1/property/sample returned it on 2 October 2026:

{
  "sample": true,
  "schema": "wattleaddr.property/v1",
  "generated_at": "2026-10-02T21:34:07+10:00",
  "query": {
    "lat": -32.85865014,
    "lon": 151.30169184
  },
  "address": {
    "matched": "25 Echidna Cl, Bellbird NSW 2325",
    "locality": "Bellbird NSW 2325",
    "gnaf_pid": "GANSW715368073",
    "confidence": "high",
    "match_level": "premise",
    "gnaf_release": null,
    "source": "WattleAddr Address API"
  },
  "jurisdiction": "NSW",
  "hazards": [
    {
      "peril": "bushfire",
      "status": "present",
      "confidence": "confirmed",
      "wattleaddr_rating": "low",
      "findings": [
        {
          "peril": "bushfire",
          "jurisdiction": "NSW",
          "category": "Vegetation Buffer",
          "wattleaddr_rating": "low",
          "published_category": null,
          "value": null,
          "units": null,
          "attrs": {
            "rfs_category": "vegetation_buffer",
            "published_category": "Vegetation Buffer"
          },
          "geometry_repaired": false,
          "repair_method": null,
          "date": "2025-11-11",
          "source": {
            "id": "nsw_bfpl",
            "title": "New South Wales — Bush Fire Prone Land",
            "publisher": "NSW Rural Fire Service",
            "licence": "CC BY 4.0",
            "attribution": "© State of New South Wales (NSW Rural Fire Service)",
            "url": "https://portal.spatial.nsw.gov.au/server/rest/services/Hosted/NSW_BushFire_Prone_Land/FeatureServer/0",
            "date_label": "Record updated",
            "currency_date": "2026-08-10"
          },
          "confidence": "confirmed",
          "method": "Bush fire prone land map made under section 10.3 of the Environmental Planning and Assessment Act 1979 and certified by the Commissioner of the NSW Rural Fire Service. Inclusion is a legal designation that triggers Planning for Bush Fire Protection requirements, not a model output. The statewide layer does not carry each council certification date, so the date shown is when the record was last updated."
        }
      ],
      "basis": "Land inside a mapped bush fire prone area is designated bush fire prone, whatever category or buffer the map puts it in. wattleaddr_rating only compares categories across States. A low rating does not lessen the designation. Found in: New South Wales — Bush Fire Prone Land."
    },
    {
      "peril": "flood",
      "status": "unmapped",
      "confidence": "unresolved",
      "wattleaddr_rating": null,
      "findings": [],
      "basis": "The NSW flood planning layer we hold has no map from this council, so this answer can say nothing about flooding here, either way. Councils hold their own flood studies. Ask the council's flood enquiry service for the flood planning level, and read the section 10.7(2) planning certificate, which states the council's flood-related planning controls."
    },
    {
      "peril": "earthquake",
      "status": "unmapped",
      "confidence": "unresolved",
      "wattleaddr_rating": null,
      "findings": [],
      "basis": "We hold no earthquake register for this location. This is not a finding that it is unaffected. No authority's map was checked for it."
    },
    {
      "peril": "cyclone",
      "status": "unmapped",
      "confidence": "unresolved",
      "wattleaddr_rating": null,
      "findings": [],
      "basis": "We hold no cyclone register for this location. This is not a finding that it is unaffected. No authority's map was checked for it."
    },
    {
      "peril": "coastal",
      "status": "unmapped",
      "confidence": "unresolved",
      "wattleaddr_rating": null,
      "findings": [],
      "basis": "We hold no coastal register for this location. This is not a finding that it is unaffected. No authority's map was checked for it."
    },
    {
      "peril": "landslide",
      "status": "unmapped",
      "confidence": "unresolved",
      "wattleaddr_rating": null,
      "findings": [],
      "basis": "We hold no landslide register for this location. This is not a finding that it is unaffected. No authority's map was checked for it."
    }
  ],
  "unmapped": [
    "flood",
    "earthquake",
    "cyclone",
    "coastal",
    "landslide"
  ],
  "land_value": {
    "state": "present",
    "note": "Land value is not what the property is worth. It is the NSW Valuer General's value of the land alone, as at 1 July each year, as if nothing were built on it. Councils rate on it. Revenue NSW uses it, averaged over up to three years, for land tax. It is not a sale price, a valuation of the property or a forecast.",
    "lot": "35//DP1057053",
    "valuer_general_property_id": 3017030,
    "latest": {
      "as_at": "2025-07-01",
      "amount_aud": 704000
    },
    "history": [
      {
        "as_at": "2012-07-01",
        "amount_aud": 239000
      },
      {
        "as_at": "2013-07-01",
        "amount_aud": 251000
      },
      {
        "as_at": "2014-07-01",
        "amount_aud": 256000
      },
      {
        "as_at": "2015-07-01",
        "amount_aud": 262000
      },
      {
        "as_at": "2016-07-01",
        "amount_aud": 271000
      },
      {
        "as_at": "2017-07-01",
        "amount_aud": 277000
      },
      {
        "as_at": "2018-07-01",
        "amount_aud": 322000
      },
      {
        "as_at": "2019-07-01",
        "amount_aud": 322000
      },
      {
        "as_at": "2020-07-01",
        "amount_aud": 322000
      },
      {
        "as_at": "2021-07-01",
        "amount_aud": 440000
      },
      {
        "as_at": "2022-07-01",
        "amount_aud": 716000
      },
      {
        "as_at": "2023-07-01",
        "amount_aud": 642000
      },
      {
        "as_at": "2024-07-01",
        "amount_aud": 665000
      },
      {
        "as_at": "2025-07-01",
        "amount_aud": 704000
      }
    ],
    "source": {
      "title": "NSW bulk land value information",
      "extract": "LV_20260901",
      "licence": "CC BY 4.0",
      "licence_url": "https://creativecommons.org/licenses/by/4.0/",
      "attribution": "© Valuer General New South Wales, NSW bulk land value information, licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). The supplied files carry CC BY 3.0 AU (https://creativecommons.org/licenses/by/3.0/au/). Arranged by WattleAddr Property from those files."
    }
  },
  "attribution": [
    "Incorporates or developed using G-NAF © Geoscape Australia licensed by the Commonwealth of Australia under the Open Geo-coded National Address File (G-NAF) End User Licence Agreement.",
    "© State of New South Wales (NSW Rural Fire Service)",
    "Australian Bureau of Statistics, Australian Statistical Geography Standard (ASGS) Edition 3, 2021 — State and Territory boundaries. Licensed under CC BY 4.0.",
    "© Department of Customer Service 10 September 2026",
    "© Valuer General New South Wales, NSW bulk land value information, licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). The supplied files carry CC BY 3.0 AU (https://creativecommons.org/licenses/by/3.0/au/). Arranged by WattleAddr Property from those files."
  ],
  "licences_note": "Whether the point is inside a mapped area, which lot it falls in, and wattleaddr_rating are WattleAddr's calculations from the datasets in licences. Each is used under the licence named in its notice. None of their publishers has reviewed or endorsed this answer.",
  "licences": [
    {
      "source": "G-NAF",
      "publisher": "Geoscape Australia",
      "licence": "Open G-NAF End User Licence Agreement",
      "url": "https://data.gov.au/data/dataset/geocoded-national-address-file-g-naf",
      "licence_url": "https://data.gov.au/data/dataset/geocoded-national-address-file-g-naf/resource/09f74802-08b1-4214-a6ea-3591b2753d30"
    },
    {
      "source": "New South Wales — Bush Fire Prone Land",
      "publisher": "NSW Rural Fire Service",
      "licence": "CC BY 4.0",
      "url": null,
      "licence_url": "https://creativecommons.org/licenses/by/4.0/"
    },
    {
      "source": "ASGS Edition 3 (2021) State and Territory boundaries",
      "publisher": "Australian Bureau of Statistics",
      "licence": "CC BY 4.0",
      "url": "https://creativecommons.org/licenses/by/4.0/",
      "licence_url": "https://creativecommons.org/licenses/by/4.0/"
    },
    {
      "source": "NSW cadastre",
      "publisher": "Department of Customer Service",
      "licence": "CC BY 4.0",
      "url": "https://www.spatial.nsw.gov.au/products_and_services/web_services/terms_and_conditions",
      "licence_url": "https://creativecommons.org/licenses/by/4.0/"
    },
    {
      "source": "nsw_lv_history",
      "publisher": "Valuer General NSW",
      "licence": "CC BY 4.0",
      "url": "https://data.nsw.gov.au/data/dataset/327f9982-e610-4ffe-a51c-4047e97c7e7d",
      "licence_url": "https://creativecommons.org/licenses/by/4.0/"
    }
  ],
  "rating_note": "wattleaddr_rating is our normalisation across jurisdictions, not the publisher's.",
  "billing": {
    "unit": "property",
    "property_key": "GANSW715368073"
  },
  "query_ms": 34.59,
  "billed": false
}

What it covers

Hazards: every state and territory whose registers we hold, as the answer’s licences list shows. Where we hold none for a hazard, it is unmapped.
Land values: New South Wales, for a property that is one whole lot. Other states, strata schemes and lots shared by several Valuer General properties return unavailable with the reason.
The answer is for the address’s point and the lot it falls in. It is research from public registers, not advice, a certificate, a title search or a valuation.

Attribution

Each register is published under its own licence, named in the answer with its exact notice (for example, NSW land values: © Valuer General New South Wales, CC BY 4.0). If you display or pass on the data, keep that notice with it, say if you changed it, and do not imply the publisher endorses you. Our Terms of Service set this out.

Errors

Errors use the same shape as the address API. The property-specific codes are property_not_enabled, property_quota_exceeded, address_not_matched, not_a_property, outside_coverage, property_unavailable, forbidden_key_type and rate_limited. None of them is billed. All of them are on the error codes page.