OI
owner-termite

API Reference

API endpoints for the Owner Termite risk checker.

Endpoints

GET
/api/risk?postcode=4000

Look up termite risk for an Australian postcode

Headers

X-API-Key: {TERMITE_API_KEY} — required, timing-safe comparison

Query Parameters

postcode — 4-digit Australian postcode (required)

Success Response (200)

{
  "postcode": "4000",
  "region": "Brisbane",
  "incidence": 26,
  "risk": "high",
  "source": "CSIRO Termite Incidence Survey (Cookson & Trajstman, 2002)",
  "disclaimer": "Risk levels are indicative only..."
}

Error Responses

StatusReason
401Missing or invalid X-API-Key
400Postcode not exactly 4 digits
404Postcode not found in dataset

Risk Level Values

very_high | high | moderate | low_moderate | low | very_low

GET
/api/health

Health check — returns { status: 'ok' }. No authentication required.