Skip to main contentSkip to main content

Value an off-market address: instant estimate or enhanced valuation (Hobby+ tier)

POST/v1/valuations2 credits (quick), 25 credits (enhance)

Value an address that isn't currently listed. Two modes, neither runs unless you ask for it by name - a request with neither flag returns 400. `"quick": true` returns an instant estimate from PropRadar's own model, synchronously, for 2 credits (no daily-cap spend). Send `bedrooms` and `bathrooms` with it: without them the range for a generic dwelling is usually too wide to publish and no estimate comes back (`missing_inputs` and `hint` in the response say what to add). Optional `land_size` and `floor_area` (square metres) tighten the range further. `"enhance": true` additionally queues the enhanced multi-source blend; returns a job `id`, poll `/v1/valuations/{id}` for the result (~30 min) - daily caps per plan: Hobby 2, Starter 4, Builder 4, Pro 6, Growth 12, Scale 30, Enterprise 100. The enhanced mode costs 25 credits, charged before the job is queued and refunded in full if the submission is rejected or an identical job was already in flight. Returns 409 if a property already exists at the address (resubmit with `"force": true` to value it anyway). Send an `Idempotency-Key` header to make retries safe.

Parameters

NameInRequiredDescription
Idempotency-KeyheadernoOpaque, caller-chosen, <=200 printable-ASCII chars. Replays return the cached response with `Idempotent-Replayed: true` and refund the credits.

Example request

curl -X POST "https://api.propradar.com.au/v1/valuations" \
  -H "X-API-Key: pr_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "address": "286 Brays Road",
  "postcode": "4503",
  "state": "QLD",
  "property_type": "House",
  "quick": true
}'

Example response

{ "status": "estimated", "source": "propradar_avm",
  "estimated_value": 712000, "estimated_value_low": 665000, "estimated_value_high": 759000,
  "estimated_rent_weekly": 480, "confidence": "Medium",
  "enhancement": { "available": true, "how": "Resubmit the same body with \"enhance\": true.", ... } }

Get an API key

Every endpoint takes an X-API-Key header. The free tier needs no credit card.

Other endpoints