Value an off-market address: instant estimate or enhanced valuation (Hobby+ tier)
/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
| Name | In | Required | Description |
|---|---|---|---|
| Idempotency-Key | header | no | Opaque, 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
- Many suburbs in one call: statistics and recent sales POST /v1/suburbs/batch
- List every suburb in the dataset (coverage index) GET /v1/suburbs
- Authenticated health probe GET /v1/health
- Account usage and credit allowance GET /v1/usage
- Resolve an address to a property_id GET /v1/properties/search
- Look up a single property GET /v1/properties/{property_id}
- Recent sold comparables (Hobby+; lat/lng mode Pro+) GET /v1/comparables
- Suburb statistics GET /v1/suburbs/{state}/{suburb}
- Trust-gated suburb rankings (Pro+ tier) GET /v1/suburbs/rankings
- Multi-criteria suburb screener (Pro+ tier) GET /v1/suburbs/screen
- Recent sold properties in a suburb GET /v1/suburbs/{state}/{suburb}/sold
- Current active listings in a suburb GET /v1/suburbs/{state}/{suburb}/listings
- Search current listings across a whole state (Pro+ tier) GET /v1/properties/listings
- Property event history GET /v1/properties/{property_id}/history
- Most recent sold record (Hobby+ tier) GET /v1/properties/{property_id}/sold_summary
- Potential sell price confidence band GET /v1/properties/{property_id}/psp_with_confidence
- Similar active listings GET /v1/properties/{property_id}/similar
- Nearby active listings GET /v1/properties/{property_id}/nearby
- Batch property lookup (Starter+ tier) POST /v1/properties/bulk
- Poll an off-market valuation job GET /v1/valuations/{id}
- Valuation range for a locality, no address needed (Pro+ tier) POST /v1/valuations/estimate
- 12-month outlook for house/unit price and rent (Pro+ tier) GET /v1/suburbs/{state}/{suburb}/forecast
- Development applications near a point (Pro+ tier) GET /v1/developments/nearby
- Properties currently advertised for rent in a suburb (Hobby+ tier) GET /v1/suburbs/{state}/{suburb}/rentals
- Weekly rent estimate for a locality, no address needed (Pro+ tier) POST /v1/rent/estimate
- Recently-modified event feed (Starter+ tier) GET /v1/properties/recently-modified
- Investment score + cashflow (Pro+ tier) GET /v1/properties/{property_id}/investment_analysis
- Market cycle classification (Pro+ tier) GET /v1/suburbs/{state}/{suburb}/market_cycle
- Annual price/rent/yield time-series (Pro+ tier) GET /v1/suburbs/{state}/{suburb}/price_history
- Market-heat time-series (Pro+ tier) GET /v1/suburbs/{state}/{suburb}/heat_history
- List macro regions (Growth+ tier) GET /v1/regions
- Region macro indicators (Growth+ tier) GET /v1/regions/{slug}
- Suggest addresses as the user types GET /v1/addresses/suggest
- Turn free text into suburbs GET /v1/suburbs/resolve