Valuations

Estimate the sale price or rent of one home

Returns the automated valuation engine's result for one home when the authenticated client has valuations.read: the same estimate, range, status and up to five comparables as the public valuation page, with the segment's measured accuracy. Pass the subject fields from /valuations/subjects. External URL: /v1/valuations. Current Next.js implementation path: /api/platform/v1/valuations. This read-only route does not require Idempotency-Key. Comparables carry month, price, PSF, floor area and storey band only; responses never include unit numbers, transaction IDs, source rows or engine internals. Each API key may make 60 requests a minute and 2,000 a day across both valuation routes; over either limit the route answers 429 rate_limit_exceeded with Retry-After. When the engine is unavailable the route answers 503 valuation_engine_unavailable and never a figure from elsewhere. Free under the partner terms: show "Estimate by Homejourney" with a link to the attribution.url, show the disclaimer, and do not resell, bulk-collect or store estimates beyond 30 days.

get/valuations

Request

  • Base URL: https://platform-api.homejourney.sg/v1
  • URL: https://platform-api.homejourney.sg/v1/valuations
  • Auth: HTTP bearer

Query parameters

side'sale' | 'rent' required

Sale price or monthly rent.

segment'hdb' | 'private_non_landed' | 'landed' | 'strata_commercial' | 'strata_industrial' | 'whole_industrial'

The subject segment from /valuations/subjects; defaults to hdb.

blockstring

HDB: the block, such as 96 or 410A.

streetstring

HDB and landed: the street name from the subject.

flat_typestring

HDB: one of the subject flat_types, such as 4 ROOM.

projectstring

Private non-landed, commercial and industrial: the project name from the subject.

districtinteger

Private non-landed, commercial and industrial: the postal district from the subject.

floor_area_sqmnumber

Floor area in square metres: from 20 for a home, from 5 for a commercial or industrial unit.

property_type'OFFICE' | 'RETAIL' | 'SHOP HOUSE' | 'MULTIPLE-USER FACTORY' | 'BUSINESS PARK' | 'SINGLE-USER FACTORY' | 'WAREHOUSE'

Commercial and industrial: one of the subject property_types, such as OFFICE; by default the most traded. Only sale is estimated.

storeyinteger

The storey.

unitstring

Private non-landed sale: the unit number, such as #13-51.

house_type'TERRACE' | 'SEMI-DETACHED' | 'DETACHED' | 'CLUSTER'

Landed: the house type.

tenure'freehold' | 'leasehold'

Landed: the tenure.

land_area_sqmnumber

Landed: land area in square metres.

built_yearinteger

Landed sale: the year built or rebuilt.

Headers

X-Correlation-Idstring

Optional partner-provided correlation ID echoed into request evidence.

Response

The engine result with the disclaimer and attribution.

disclaimer'An automated estimate from recorded transactions, not a valuation by a licensed valuer. Do not rely on it for a loan, sale or legal decision.' required
livemodeboolean required
request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.