Land tax on a property (at its land value)
/v1/properties/{gnaf_id}/calculators/land-tax16¢ per callAnnual land tax on this property if it were the owner's only taxable
land — the same calculation as /calculators/land-tax, with the state
taken from the property and the land value set to its latest land valuation
(land_value_source: land_valuation).
Land tax is charged on everything an owner holds in the state combined, so
for an owner with other land this understates the bill: add the land values
together and use /calculators/land-tax. Priced as the calculator plus the
land values. Land valuations are held for NSW properties today; elsewhere,
and for a property with no valuation, the answer is available: false.
Authorization
Request
The only values you send. Fields under Responses below are what comes back — you never pass those.
Path parameters
gnaf_idstringrequiredQuery parameters
owner_typestringoptionalOne of: individual, company, trust.
foreignbooleanoptionalA foreign or absentee owner — adds the state's surcharge.
principal_residencebooleanoptionalThe owner lives here. Always exempt; returns 0 with the reason.
assessment_datestring · dateoptionalAny date in the land tax year (YYYY-MM-DD). Default: today in Sydney.
Responses
Successful Response
statestringalways returnedland_valuenumberalways returnedTaxable land value used: the total you passed, or the property's latest land value on the property route.
land_value_sourcestringalways returned`input` or `land_valuation` (the property's latest land value).
gnaf_idstringmay be nullThe property, on the property route; null otherwise.
owner_typestringalways returnedindividual, company or trust.
foreignbooleanalways returnedWhether the foreign / absentee owner surcharge was applied.
principal_residencebooleanalways returnedTrue when the land is the owner's home (exempt).
assessment_datestring · datealways returnedDate the land tax year was picked for.
thresholdnumbermay be nullTax-free threshold that applied (null when none, e.g. trusts in some states, or no land tax).
total_land_taxnumberalways returnedLand tax for the year, including any surcharge.
effective_rate_pctnumbermay be nulltotal_land_tax as a % of land_value; null when land_value is 0.
breakdownarray of CalcLinealways returnedEvery step, in order; amounts sum to total_land_tax.
ratesobjectalways returnedWhich rates table the answer used. Rates change each financial year (or land tax year); the version in force on your date is picked for you.
caveatsarray of stringalways returnedAbout this data
What this is
Annual land tax on one property at its latest official land valuation, as if it were the owner's only taxable land in the state. The working is the same as /v1/calculators/land-tax.
What people use it for
- Investors: see the yearly land tax a rental property will attract before buying it.
- Property pages: show holding costs next to the price.
- Advisers: a starting point for a client's land tax bill.
Coverage
NSW properties, where we hold land valuations; elsewhere, and for a property without a valuation, the response is available: false. An owner with other land in the state pays more than this figure: add the land values together and use /v1/calculators/land-tax.
/v1/properties/{gnaf_id}/calculators/land-taxcurl --request GET \
--url 'https://api.microburbs.com.au/v1/properties/GANSW704074813/calculators/land-tax' \
--header 'Authorization: Bearer test'{
"data": {
"assessment_date": "2026-11-12",
"breakdown": [
{
"amount": 6900,
"detail": "$1,500,000 on the general rate: $100 + 1.6% of the value over $1,075,000.",
"item": "Land tax"
}
],
"caveats": [
"Land tax is charged on the average of your land's last 3 yearly values; enter that average for the closest estimate."
],
"effective_rate_pct": 0.46,
"foreign": false,
"land_value": 1500000,
"land_value_source": "input",
"owner_type": "individual",
"principal_residence": false,
"rates": {
"effective_from": "2026-01-01",
"version": "NSW-land-tax-2026"
},
"state": "NSW",
"threshold": 1075000,
"total_land_tax": 6900
}
}