Quickstart

Make the first request.

curl -G 'https://daleads.com.au/api/v1/property?address=15%20Cliff%20Drive%20Katoomba%20NSW%202780&components=scores.bushfire,hazards.bushfire' \
  -H 'Authorization: Bearer dk_your_key'

No key yet? Open the committed keyless sample.

Response contract

Read the result and its evidence together.

{
  "scores": {
    "bushfire": {
      "score": 45,
      "label": "Moderate Risk",
      "disclaimer": "Preliminary screen based on AS 3959 Method 1 as implemented in Geoscience Australia\u0027s open-source BAL Toolbox. Not a certified BAL assessment. Cannot be used for building approval.",
      "coverage": {
        "official_overlay": "data_returned",
        "vegetation_fuel": "data_returned",
        "terrain_slope": "data_returned",
        "fire_history": "data_returned"
      },
      "indicative_bal": {
        "bal": "BAL-29",
        "range": [
          "BAL-19",
          "BAL-40"
        ],
        "confidence": "moderate"
      },
      "delivery_contract": {
        "subject_identity": "resolved_address_on_parcel",
        "preliminary_bal": {
          "included": true,
          "status": "included_preliminary_screen"
        }
      }
    }
  },
  "hazards": {
    "bushfire": [
      {
        "source": "nsw_hazard_bushfire",
        "state": "nsw"
      }
    ]
  }
}

Requested components: scores.bushfire, hazards.bushfire. Runtime responses also carry completeness, coverage status, model/source version and attribution for the fields actually delivered.

Coverage and limitations

Do not turn missing evidence into a clean result.

The standard Bushfire Screening API returns a preliminary indicative BAL pre-screen band only (with range and confidence), never a certified BAL assessment. It is based on AS 3959 Method 1 as implemented in Geoscience Australia's open-source BAL Toolbox, cannot be used for building approval, and carries no accuracy SLA.

This API is preliminary property screening, not a certified BAL assessment, building approval, construction recommendation or insurance decision. Do not infer BAL from the 0-100 score.

The authenticated Property OpenAPI reference contains the complete field contract and response-specific attribution. Internal provider endpoints and model recipes are not part of the public guide.

Metering

1,000 unique addresses per calendar month.

The meter is address-based. Repeating the same resolved property during the same period does not consume another unit. Read usage.billing_period_key, usage.period_quota and usage.resets_at from the response.

MCP and Skill workflow

Sample before calling.

uvx daleads-mcp

property_sample()
property_sandbox_addresses()
property_intelligence(address="…", components="scores.bushfire, hazards.bushfire")

Failure semantics

Errors remain actionable.

Status	Meaning	Action
401/403	Missing key or component entitlement	Check account capabilities
422	Address/input could not resolve	Pass a fuller address or coordinates
429	Period quota exhausted	Read resets_at or upgrade
503	A required component is unavailable	Retry; do not treat it as clear