Search
K
Market Valuation

Market Valuation

1.0.0OAS 3.0

Produces an initial price indication for a property - based on comparable
sales in the area, the local rent index and the property’s own
characteristics.

The result is an indication, not a formal valuation report prepared
under a certified appraisal standard. Every response therefore carries a
range and a note on the underlying data basis, so it stays clear in
conversations with clients how reliable the figure is.

API Base URL
  • Server 1:https://api.realestateagency.example/v1

    Production

  • Server 2:https://sandbox.api.realestateagency.example/v1

    Sandbox

Security
apiKey (apiKey)

Every call carries an API key in the apikey header. You generate the
key in the Real Estate portal under “My Apps”; it’s shown exactly once.

Each key has the scopes it’s allowed to use attached to it. If one is
missing, the API responds with 403 and code: "scope_missing"; the
missing scope is in details[].field.

Additional Information
Contact API Support - Real Estate Agency (api-support@realestateagency.example)

Valuations

Request a valuation

Starts a valuation. Either for an existing property via property_id
or for freeform input via characteristics - for example during an
initial consultation, before a property record exists.

post

Body

application/json

ValuationRequest

Exactly one of property_id or characteristics must be set.

property_idstring

Example:prop_8f2c1a

reasonstringrequired

Allowed values:initial_consultationsalerentalfinancinginheritance

Example:sale

characteristicsobject

Freeform property description, used when no property record exists.

Show Child Parameters

Response

application/json

Valuation created

ValuationResult

idstring

Example:val_3e18

property_idstring | null

Example:prop_8f2c1a

reasonstring

Allowed values:initial_consultationsalerentalfinancinginheritance

Example:sale

market_value_eurinteger

Example:638000

range_eurobject
Show Child Parameters
price_per_sqm_eurinteger

Example:7376

confidencestring

How reliable the indication is.

Allowed values:lowmediumhigh

basisobject

What the indication was derived from.

Show Child Parameters
created_atstring(date-time)

Example:2026-08-20T09:52:00Z

post/valuations

Body

{ "property_id": "prop_8f2c1a", "reason": "sale" }
 
application/json

Retrieve a valuation

get

Path Parameters

valuationIdstringrequired

Example:val_3e18

Response

application/json

Valuation

ValuationResult

idstring

Example:val_3e18

property_idstring | null

Example:prop_8f2c1a

reasonstring

Allowed values:initial_consultationsalerentalfinancinginheritance

Example:sale

market_value_eurinteger

Example:638000

range_eurobject
Show Child Parameters
price_per_sqm_eurinteger

Example:7376

confidencestring

How reliable the indication is.

Allowed values:lowmediumhigh

basisobject

What the indication was derived from.

Show Child Parameters
created_atstring(date-time)

Example:2026-08-20T09:52:00Z

get/valuations/{valuationId}
 
application/json

Comparables