Property - Valuation

Negative-gearing stat

GET/v1/properties/{gnaf_id}/valuation/negative-gearing20¢ per call

Negative-gearing stat at the finest available level: per-property cashflow scenarios (80% + 105% LVR), falling back to mesh-block then suburb investor-exposure.

Price: 20¢ per call.

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

NegativeGearingfields returned to you

levelstringalways returned

Resolution the stat was found at: per-property, mesh-block, or suburb.

is_negatively_gearedbooleanmay be null

Rent minus interest at 80% LVR is negative (property level).

net_cashflow_80lvrnumbermay be null

Net cashflow AUD/yr at the headline 80% LVR (property level).

net_cashflow_105lvrnumbermay be null

Net cashflow AUD/yr at the 105% equity-release scenario (property level).

net_cashflow_80lvr_wknumbermay be null

Net cashflow AUD/wk at 80% LVR (property level).

gross_yield_pctnumbermay be null

Gross rental yield, already a percent (property level).

lvr_defaultnumbermay be null

Headline-scenario LVR, 0-1 (property level).

rent_estimate_suspectbooleanmay be null

Upstream rent under-predicts — yield/cashflow indicative only (property level).

salstringmay be null

Suburb (SAL) name (mb/suburb level).

exposurenumbermay be null

Share of dwellings held by negatively-geared landlords, 0-1 (mb/suburb level).

tierstringmay be null

Exposure tier (e.g. 'Very high', 'High', 'Medium', 'Low') (mb/suburb level).

private_rental_sharenumbermay be null

Private-rental share of dwellings, 0-1 (suburb level only).

share_tax_loss_makingnumbermay be null

Share of investor candidates that are tax-loss-making, 0-1 (mb/suburb level).

n_investor_candidatesintegermay be null

Number of investor candidates scored (mb/suburb level).

realistic_lvrnumbermay be null

Mean LVR among candidates, 0-1 (mb level only).

GET/v1/properties/{gnaf_id}/valuation/negative-gearing

cURL

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

Example Responses

Show schema

{
  "data": {
    "gross_yield_pct": 0.57,
    "is_negatively_geared": true,
    "level": "property",
    "lvr_default": 0.8,
    "net_cashflow_105lvr": -255336,
    "net_cashflow_80lvr": -189996,
    "net_cashflow_80lvr_wk": -3654,
    "rent_estimate_suspect": true
  }
}

Successful Response200

application/json