---
title: "ValuationRequest"
url: "https://real-estate-agency.apim.eu/apis/market-valuation/versions/3b18507e-d857-48a4-a3bc-b79b2eb2cfa4/schemas/ValuationRequest"
---

> Full API specification: https://real-estate-agency.apim.eu/apis/market-valuation/versions/3b18507e-d857-48a4-a3bc-b79b2eb2cfa4.md

# ValuationRequest

Exactly one of `property_id` or `characteristics` must be set.

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Market Valuation
  version: 1.0.0
servers:
  - url: https://api.realestateagency.example/v1
    description: Production
  - url: https://sandbox.api.realestateagency.example/v1
    description: Sandbox
components:
  schemas:
    Reason:
      type: string
      enum:
        - initial_consultation
        - sale
        - rental
        - financing
        - inheritance
      example: sale
    Characteristics:
      type: object
      description: Freeform property description, used when no property record exists.
      required:
        - type
        - postal_code
        - living_area_sqm
      properties:
        type:
          type: string
          enum:
            - apartment
            - house
            - land
            - commercial
        postal_code:
          type: string
          pattern: ^[0-9]{5}$
          example: "10001"
        living_area_sqm:
          type: number
          format: float
          example: 86.5
        lot_size_sqm:
          type: number
          format: float
          example: 412
        rooms:
          type: number
          format: float
          example: 3
        year_built:
          type: integer
          example: 1908
        condition:
          type: string
          enum:
            - needs_renovation
            - well_maintained
            - modernized
            - like_new
        finish_level:
          type: string
          enum:
            - basic
            - standard
            - upscale
            - luxury
        balcony:
          type: boolean
          example: true
        elevator:
          type: boolean
          example: false
        parking_space:
          type: boolean
          example: false
    ValuationRequest:
      type: object
      required:
        - reason
      description: Exactly one of `property_id` or `characteristics` must be set.
      properties:
        property_id:
          type: string
          example: prop_8f2c1a
        reason:
          $ref: "#/components/schemas/Reason"
        characteristics:
          $ref: "#/components/schemas/Characteristics"
```