Poll an off-market valuation job
GET
/v1/valuations/{id}Free every 30sFree once every 30 seconds per job: the first poll in each 30-second window costs nothing, and repeats inside the window return the same cached response and cost 1 credit. The `X-Poll-After` header gives the seconds until the next free poll. Returns the status of a job from POST /v1/valuations. Scoped to your API key's owner (other keys' jobs return 404). While pending/processing it returns an ETA; when completed it returns the estimate, weekly rent, yield, and potential sell price inline (investment score on Pro+), plus a link to the full `/v1/properties/{id}` record.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
| id | path | yes | Job id from the POST /v1/valuations response. |
Example request
curl "https://api.propradar.com.au/v1/valuations/{id}" \
-H "X-API-Key: pr_live_..."Example response
{ "id": 4815, "status": "completed",
"address": "286 Brays Road", "property_id": "c8868204",
"attributes": { "bedrooms": 5, "bathrooms": 3, "parking": 5,
"property_type": "House", "land_size_sqm": 1999 },
"valuation": { "estimated_value": 1510000, "estimated_value_low": 1330000,
"estimated_value_high": 1690000, "confidence": "high" },
"rental": { "estimated_weekly": 935, "estimated_yield_pct": 3.2, "confidence": "high" },
"potential_sell_price": 1510000,
"analytics": { "investment_score": 71.5, "investment_score_confidence": "high" },
"_links": { "property": "/v1/properties/c8868204" } }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
- Value an off-market address: instant estimate or enhanced valuation (Hobby+ tier) POST /v1/valuations
- 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