Validate a listing

curl --request POST \
  --url https://staging.housera.ro/api/v1/listings/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "city": "<string>",
  "street": "<string>",
  "latitude": 0,
  "longitude": 0,
  "contact_name": "<string>",
  "contact_phone": "<string>",
  "contact_email": "jsmith@example.com",
  "content_locale": "<string>",
  "county": "<string>",
  "country": "<string>",
  "area": "<string>",
  "address": "<string>",
  "street_number": "<string>",
  "street_manual": true,
  "landmark": "<string>",
  "rooms": 20,
  "bedrooms": 15,
  "bathrooms": 250,
  "floor": "<string>",
  "total_floors": 30,
  "usable_area_sqm": 250000.5,
  "built_area_sqm": 250000.5,
  "land_area_sqm": 5000000.5,
  "year_built": 1514,
  "price": 500000000000,
  "price_currency": "<string>",
  "deposit_months": 1,
  "deposit_amount": 500000000000,
  "no_commission": true,
  "utilities_included": true,
  "accepts_trade": true,
  "trade_accepts": [],
  "trade_other": "<string>",
  "heating_types": [
    "<string>"
  ],
  "materials": [
    ""
  ],
  "flood_risk": true,
  "underground_levels": [],
  "parcel": [
    [
      123
    ]
  ],
  "land_frontage": 5000,
  "pot": 50,
  "cut": 10,
  "clearance_height": 50,
  "power_capacity": 50000,
  "floor_load_capacity": 50000,
  "dock_doors_count": 250,
  "orientations": [],
  "parking_spots": 2500,
  "balconies": 10,
  "terraces": 10,
  "kitchens": 25,
  "garages": 25,
  "lifts": 25,
  "underground_floors": 5,
  "interior_height": 50,
  "renovated_year": 1514,
  "apartments_count": 2500,
  "energy_consumption": 2500,
  "energy_renewable": 2500,
  "emission_index": 500,
  "shopfront_width": 500,
  "occupancy_rate": 50,
  "maintenance_cost": 50000,
  "upfront_cost": 500000000,
  "upfront_percent": 99,
  "parking_surface_cost": 500000,
  "parking_underground_cost": 500000,
  "surface_total": 500000,
  "surface_balconies": 500000,
  "surface_terrace": 500000,
  "surface_yard": 500000,
  "surface_office": 500000,
  "surface_office_available": 500000,
  "surface_office_minimum": 500000,
  "surface_production": 500000,
  "surface_storage": 500000,
  "footprint": 500000,
  "street_openings": 10,
  "openings_length": 5000,
  "access_road_width": 50,
  "utilities_distance": 50000,
  "construction_on_land": true,
  "land_utr": "<string>",
  "land_height_max": 250,
  "land_width": 50000,
  "land_length": 50000,
  "surface_display": 500000,
  "finishing": "<string>",
  "technical_details": "<string>",
  "nearby": "<string>",
  "available_from_note": "<string>",
  "commission_note": "<string>",
  "commission_percent": 10,
  "commission_vat": true,
  "available_from": "2023-12-25",
  "retired_floors": 25,
  "lockers_count": 500,
  "negotiable": true,
  "historical_monument": true,
  "property_for_investment": true,
  "delivery_quarter": 2,
  "delivery_year": 2018,
  "sections_count": 20,
  "reg_s": 10,
  "reg_d": 0,
  "reg_p": 0,
  "reg_e": 100,
  "phases_count": 10,
  "unit_types": [
    {
      "label": "<string>",
      "floors": "<string>",
      "area_sqm": 5000.5,
      "area_sqm_to": 5000.5,
      "units_count": 5000,
      "price_from": 500000000,
      "rooms": 10
    }
  ],
  "features": [
    "<string>"
  ],
  "pet_friendly": true,
  "media_links": {
    "video": "<string>",
    "tour": "<string>",
    "plan": "<string>"
  },
  "photo_keys": [
    "<string>"
  ],
  "photo_meta": [
    {
      "floor": "<string>",
      "rooms": [
        "<string>"
      ]
    }
  ],
  "idempotency_key": "<string>"
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://staging.housera.ro/api/v1/listings/validate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '<string>',
    'description' => '<string>',
    'city' => '<string>',
    'street' => '<string>',
    'latitude' => 0,
    'longitude' => 0,
    'contact_name' => '<string>',
    'contact_phone' => '<string>',
    'contact_email' => 'jsmith@example.com',
    'content_locale' => '<string>',
    'county' => '<string>',
    'country' => '<string>',
    'area' => '<string>',
    'address' => '<string>',
    'street_number' => '<string>',
    'street_manual' => true,
    'landmark' => '<string>',
    'rooms' => 20,
    'bedrooms' => 15,
    'bathrooms' => 250,
    'floor' => '<string>',
    'total_floors' => 30,
    'usable_area_sqm' => 250000.5,
    'built_area_sqm' => 250000.5,
    'land_area_sqm' => 5000000.5,
    'year_built' => 1514,
    'price' => 500000000000,
    'price_currency' => '<string>',
    'deposit_months' => 1,
    'deposit_amount' => 500000000000,
    'no_commission' => true,
    'utilities_included' => true,
    'accepts_trade' => true,
    'trade_accepts' => [
        
    ],
    'trade_other' => '<string>',
    'heating_types' => [
        '<string>'
    ],
    'materials' => [
        ''
    ],
    'flood_risk' => true,
    'underground_levels' => [
        
    ],
    'parcel' => [
        [
                123
        ]
    ],
    'land_frontage' => 5000,
    'pot' => 50,
    'cut' => 10,
    'clearance_height' => 50,
    'power_capacity' => 50000,
    'floor_load_capacity' => 50000,
    'dock_doors_count' => 250,
    'orientations' => [
        
    ],
    'parking_spots' => 2500,
    'balconies' => 10,
    'terraces' => 10,
    'kitchens' => 25,
    'garages' => 25,
    'lifts' => 25,
    'underground_floors' => 5,
    'interior_height' => 50,
    'renovated_year' => 1514,
    'apartments_count' => 2500,
    'energy_consumption' => 2500,
    'energy_renewable' => 2500,
    'emission_index' => 500,
    'shopfront_width' => 500,
    'occupancy_rate' => 50,
    'maintenance_cost' => 50000,
    'upfront_cost' => 500000000,
    'upfront_percent' => 99,
    'parking_surface_cost' => 500000,
    'parking_underground_cost' => 500000,
    'surface_total' => 500000,
    'surface_balconies' => 500000,
    'surface_terrace' => 500000,
    'surface_yard' => 500000,
    'surface_office' => 500000,
    'surface_office_available' => 500000,
    'surface_office_minimum' => 500000,
    'surface_production' => 500000,
    'surface_storage' => 500000,
    'footprint' => 500000,
    'street_openings' => 10,
    'openings_length' => 5000,
    'access_road_width' => 50,
    'utilities_distance' => 50000,
    'construction_on_land' => true,
    'land_utr' => '<string>',
    'land_height_max' => 250,
    'land_width' => 50000,
    'land_length' => 50000,
    'surface_display' => 500000,
    'finishing' => '<string>',
    'technical_details' => '<string>',
    'nearby' => '<string>',
    'available_from_note' => '<string>',
    'commission_note' => '<string>',
    'commission_percent' => 10,
    'commission_vat' => true,
    'available_from' => '2023-12-25',
    'retired_floors' => 25,
    'lockers_count' => 500,
    'negotiable' => true,
    'historical_monument' => true,
    'property_for_investment' => true,
    'delivery_quarter' => 2,
    'delivery_year' => 2018,
    'sections_count' => 20,
    'reg_s' => 10,
    'reg_d' => 0,
    'reg_p' => 0,
    'reg_e' => 100,
    'phases_count' => 10,
    'unit_types' => [
        [
                'label' => '<string>',
                'floors' => '<string>',
                'area_sqm' => 5000.5,
                'area_sqm_to' => 5000.5,
                'units_count' => 5000,
                'price_from' => 500000000,
                'rooms' => 10
        ]
    ],
    'features' => [
        '<string>'
    ],
    'pet_friendly' => true,
    'media_links' => [
        'video' => '<string>',
        'tour' => '<string>',
        'plan' => '<string>'
    ],
    'photo_keys' => [
        '<string>'
    ],
    'photo_meta' => [
        [
                'floor' => '<string>',
                'rooms' => [
                                '<string>'
                ]
        ]
    ],
    'idempotency_key' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: '<string>',
    description: '<string>',
    city: '<string>',
    street: '<string>',
    latitude: 0,
    longitude: 0,
    contact_name: '<string>',
    contact_phone: '<string>',
    contact_email: 'jsmith@example.com',
    content_locale: '<string>',
    county: '<string>',
    country: '<string>',
    area: '<string>',
    address: '<string>',
    street_number: '<string>',
    street_manual: true,
    landmark: '<string>',
    rooms: 20,
    bedrooms: 15,
    bathrooms: 250,
    floor: '<string>',
    total_floors: 30,
    usable_area_sqm: 250000.5,
    built_area_sqm: 250000.5,
    land_area_sqm: 5000000.5,
    year_built: 1514,
    price: 500000000000,
    price_currency: '<string>',
    deposit_months: 1,
    deposit_amount: 500000000000,
    no_commission: true,
    utilities_included: true,
    accepts_trade: true,
    trade_accepts: [],
    trade_other: '<string>',
    heating_types: ['<string>'],
    materials: [''],
    flood_risk: true,
    underground_levels: [],
    parcel: [[123]],
    land_frontage: 5000,
    pot: 50,
    cut: 10,
    clearance_height: 50,
    power_capacity: 50000,
    floor_load_capacity: 50000,
    dock_doors_count: 250,
    orientations: [],
    parking_spots: 2500,
    balconies: 10,
    terraces: 10,
    kitchens: 25,
    garages: 25,
    lifts: 25,
    underground_floors: 5,
    interior_height: 50,
    renovated_year: 1514,
    apartments_count: 2500,
    energy_consumption: 2500,
    energy_renewable: 2500,
    emission_index: 500,
    shopfront_width: 500,
    occupancy_rate: 50,
    maintenance_cost: 50000,
    upfront_cost: 500000000,
    upfront_percent: 99,
    parking_surface_cost: 500000,
    parking_underground_cost: 500000,
    surface_total: 500000,
    surface_balconies: 500000,
    surface_terrace: 500000,
    surface_yard: 500000,
    surface_office: 500000,
    surface_office_available: 500000,
    surface_office_minimum: 500000,
    surface_production: 500000,
    surface_storage: 500000,
    footprint: 500000,
    street_openings: 10,
    openings_length: 5000,
    access_road_width: 50,
    utilities_distance: 50000,
    construction_on_land: true,
    land_utr: '<string>',
    land_height_max: 250,
    land_width: 50000,
    land_length: 50000,
    surface_display: 500000,
    finishing: '<string>',
    technical_details: '<string>',
    nearby: '<string>',
    available_from_note: '<string>',
    commission_note: '<string>',
    commission_percent: 10,
    commission_vat: true,
    available_from: '2023-12-25',
    retired_floors: 25,
    lockers_count: 500,
    negotiable: true,
    historical_monument: true,
    property_for_investment: true,
    delivery_quarter: 2,
    delivery_year: 2018,
    sections_count: 20,
    reg_s: 10,
    reg_d: 0,
    reg_p: 0,
    reg_e: 100,
    phases_count: 10,
    unit_types: [
      {
        label: '<string>',
        floors: '<string>',
        area_sqm: 5000.5,
        area_sqm_to: 5000.5,
        units_count: 5000,
        price_from: 500000000,
        rooms: 10
      }
    ],
    features: ['<string>'],
    pet_friendly: true,
    media_links: {video: '<string>', tour: '<string>', plan: '<string>'},
    photo_keys: ['<string>'],
    photo_meta: [{floor: '<string>', rooms: ['<string>']}],
    idempotency_key: '<string>'
  })
};

fetch('https://staging.housera.ro/api/v1/listings/validate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://staging.housera.ro/api/v1/listings/validate"

payload = {
    "title": "<string>",
    "description": "<string>",
    "city": "<string>",
    "street": "<string>",
    "latitude": 0,
    "longitude": 0,
    "contact_name": "<string>",
    "contact_phone": "<string>",
    "contact_email": "jsmith@example.com",
    "content_locale": "<string>",
    "county": "<string>",
    "country": "<string>",
    "area": "<string>",
    "address": "<string>",
    "street_number": "<string>",
    "street_manual": True,
    "landmark": "<string>",
    "rooms": 20,
    "bedrooms": 15,
    "bathrooms": 250,
    "floor": "<string>",
    "total_floors": 30,
    "usable_area_sqm": 250000.5,
    "built_area_sqm": 250000.5,
    "land_area_sqm": 5000000.5,
    "year_built": 1514,
    "price": 500000000000,
    "price_currency": "<string>",
    "deposit_months": 1,
    "deposit_amount": 500000000000,
    "no_commission": True,
    "utilities_included": True,
    "accepts_trade": True,
    "trade_accepts": [],
    "trade_other": "<string>",
    "heating_types": ["<string>"],
    "materials": [""],
    "flood_risk": True,
    "underground_levels": [],
    "parcel": [[123]],
    "land_frontage": 5000,
    "pot": 50,
    "cut": 10,
    "clearance_height": 50,
    "power_capacity": 50000,
    "floor_load_capacity": 50000,
    "dock_doors_count": 250,
    "orientations": [],
    "parking_spots": 2500,
    "balconies": 10,
    "terraces": 10,
    "kitchens": 25,
    "garages": 25,
    "lifts": 25,
    "underground_floors": 5,
    "interior_height": 50,
    "renovated_year": 1514,
    "apartments_count": 2500,
    "energy_consumption": 2500,
    "energy_renewable": 2500,
    "emission_index": 500,
    "shopfront_width": 500,
    "occupancy_rate": 50,
    "maintenance_cost": 50000,
    "upfront_cost": 500000000,
    "upfront_percent": 99,
    "parking_surface_cost": 500000,
    "parking_underground_cost": 500000,
    "surface_total": 500000,
    "surface_balconies": 500000,
    "surface_terrace": 500000,
    "surface_yard": 500000,
    "surface_office": 500000,
    "surface_office_available": 500000,
    "surface_office_minimum": 500000,
    "surface_production": 500000,
    "surface_storage": 500000,
    "footprint": 500000,
    "street_openings": 10,
    "openings_length": 5000,
    "access_road_width": 50,
    "utilities_distance": 50000,
    "construction_on_land": True,
    "land_utr": "<string>",
    "land_height_max": 250,
    "land_width": 50000,
    "land_length": 50000,
    "surface_display": 500000,
    "finishing": "<string>",
    "technical_details": "<string>",
    "nearby": "<string>",
    "available_from_note": "<string>",
    "commission_note": "<string>",
    "commission_percent": 10,
    "commission_vat": True,
    "available_from": "2023-12-25",
    "retired_floors": 25,
    "lockers_count": 500,
    "negotiable": True,
    "historical_monument": True,
    "property_for_investment": True,
    "delivery_quarter": 2,
    "delivery_year": 2018,
    "sections_count": 20,
    "reg_s": 10,
    "reg_d": 0,
    "reg_p": 0,
    "reg_e": 100,
    "phases_count": 10,
    "unit_types": [
        {
            "label": "<string>",
            "floors": "<string>",
            "area_sqm": 5000.5,
            "area_sqm_to": 5000.5,
            "units_count": 5000,
            "price_from": 500000000,
            "rooms": 10
        }
    ],
    "features": ["<string>"],
    "pet_friendly": True,
    "media_links": {
        "video": "<string>",
        "tour": "<string>",
        "plan": "<string>"
    },
    "photo_keys": ["<string>"],
    "photo_meta": [
        {
            "floor": "<string>",
            "rooms": ["<string>"]
        }
    ],
    "idempotency_key": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "valid": true
}

POST

listings

validate

Validate a listing

curl --request POST \
  --url https://staging.housera.ro/api/v1/listings/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "city": "<string>",
  "street": "<string>",
  "latitude": 0,
  "longitude": 0,
  "contact_name": "<string>",
  "contact_phone": "<string>",
  "contact_email": "jsmith@example.com",
  "content_locale": "<string>",
  "county": "<string>",
  "country": "<string>",
  "area": "<string>",
  "address": "<string>",
  "street_number": "<string>",
  "street_manual": true,
  "landmark": "<string>",
  "rooms": 20,
  "bedrooms": 15,
  "bathrooms": 250,
  "floor": "<string>",
  "total_floors": 30,
  "usable_area_sqm": 250000.5,
  "built_area_sqm": 250000.5,
  "land_area_sqm": 5000000.5,
  "year_built": 1514,
  "price": 500000000000,
  "price_currency": "<string>",
  "deposit_months": 1,
  "deposit_amount": 500000000000,
  "no_commission": true,
  "utilities_included": true,
  "accepts_trade": true,
  "trade_accepts": [],
  "trade_other": "<string>",
  "heating_types": [
    "<string>"
  ],
  "materials": [
    ""
  ],
  "flood_risk": true,
  "underground_levels": [],
  "parcel": [
    [
      123
    ]
  ],
  "land_frontage": 5000,
  "pot": 50,
  "cut": 10,
  "clearance_height": 50,
  "power_capacity": 50000,
  "floor_load_capacity": 50000,
  "dock_doors_count": 250,
  "orientations": [],
  "parking_spots": 2500,
  "balconies": 10,
  "terraces": 10,
  "kitchens": 25,
  "garages": 25,
  "lifts": 25,
  "underground_floors": 5,
  "interior_height": 50,
  "renovated_year": 1514,
  "apartments_count": 2500,
  "energy_consumption": 2500,
  "energy_renewable": 2500,
  "emission_index": 500,
  "shopfront_width": 500,
  "occupancy_rate": 50,
  "maintenance_cost": 50000,
  "upfront_cost": 500000000,
  "upfront_percent": 99,
  "parking_surface_cost": 500000,
  "parking_underground_cost": 500000,
  "surface_total": 500000,
  "surface_balconies": 500000,
  "surface_terrace": 500000,
  "surface_yard": 500000,
  "surface_office": 500000,
  "surface_office_available": 500000,
  "surface_office_minimum": 500000,
  "surface_production": 500000,
  "surface_storage": 500000,
  "footprint": 500000,
  "street_openings": 10,
  "openings_length": 5000,
  "access_road_width": 50,
  "utilities_distance": 50000,
  "construction_on_land": true,
  "land_utr": "<string>",
  "land_height_max": 250,
  "land_width": 50000,
  "land_length": 50000,
  "surface_display": 500000,
  "finishing": "<string>",
  "technical_details": "<string>",
  "nearby": "<string>",
  "available_from_note": "<string>",
  "commission_note": "<string>",
  "commission_percent": 10,
  "commission_vat": true,
  "available_from": "2023-12-25",
  "retired_floors": 25,
  "lockers_count": 500,
  "negotiable": true,
  "historical_monument": true,
  "property_for_investment": true,
  "delivery_quarter": 2,
  "delivery_year": 2018,
  "sections_count": 20,
  "reg_s": 10,
  "reg_d": 0,
  "reg_p": 0,
  "reg_e": 100,
  "phases_count": 10,
  "unit_types": [
    {
      "label": "<string>",
      "floors": "<string>",
      "area_sqm": 5000.5,
      "area_sqm_to": 5000.5,
      "units_count": 5000,
      "price_from": 500000000,
      "rooms": 10
    }
  ],
  "features": [
    "<string>"
  ],
  "pet_friendly": true,
  "media_links": {
    "video": "<string>",
    "tour": "<string>",
    "plan": "<string>"
  },
  "photo_keys": [
    "<string>"
  ],
  "photo_meta": [
    {
      "floor": "<string>",
      "rooms": [
        "<string>"
      ]
    }
  ],
  "idempotency_key": "<string>"
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://staging.housera.ro/api/v1/listings/validate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '<string>',
    'description' => '<string>',
    'city' => '<string>',
    'street' => '<string>',
    'latitude' => 0,
    'longitude' => 0,
    'contact_name' => '<string>',
    'contact_phone' => '<string>',
    'contact_email' => 'jsmith@example.com',
    'content_locale' => '<string>',
    'county' => '<string>',
    'country' => '<string>',
    'area' => '<string>',
    'address' => '<string>',
    'street_number' => '<string>',
    'street_manual' => true,
    'landmark' => '<string>',
    'rooms' => 20,
    'bedrooms' => 15,
    'bathrooms' => 250,
    'floor' => '<string>',
    'total_floors' => 30,
    'usable_area_sqm' => 250000.5,
    'built_area_sqm' => 250000.5,
    'land_area_sqm' => 5000000.5,
    'year_built' => 1514,
    'price' => 500000000000,
    'price_currency' => '<string>',
    'deposit_months' => 1,
    'deposit_amount' => 500000000000,
    'no_commission' => true,
    'utilities_included' => true,
    'accepts_trade' => true,
    'trade_accepts' => [
        
    ],
    'trade_other' => '<string>',
    'heating_types' => [
        '<string>'
    ],
    'materials' => [
        ''
    ],
    'flood_risk' => true,
    'underground_levels' => [
        
    ],
    'parcel' => [
        [
                123
        ]
    ],
    'land_frontage' => 5000,
    'pot' => 50,
    'cut' => 10,
    'clearance_height' => 50,
    'power_capacity' => 50000,
    'floor_load_capacity' => 50000,
    'dock_doors_count' => 250,
    'orientations' => [
        
    ],
    'parking_spots' => 2500,
    'balconies' => 10,
    'terraces' => 10,
    'kitchens' => 25,
    'garages' => 25,
    'lifts' => 25,
    'underground_floors' => 5,
    'interior_height' => 50,
    'renovated_year' => 1514,
    'apartments_count' => 2500,
    'energy_consumption' => 2500,
    'energy_renewable' => 2500,
    'emission_index' => 500,
    'shopfront_width' => 500,
    'occupancy_rate' => 50,
    'maintenance_cost' => 50000,
    'upfront_cost' => 500000000,
    'upfront_percent' => 99,
    'parking_surface_cost' => 500000,
    'parking_underground_cost' => 500000,
    'surface_total' => 500000,
    'surface_balconies' => 500000,
    'surface_terrace' => 500000,
    'surface_yard' => 500000,
    'surface_office' => 500000,
    'surface_office_available' => 500000,
    'surface_office_minimum' => 500000,
    'surface_production' => 500000,
    'surface_storage' => 500000,
    'footprint' => 500000,
    'street_openings' => 10,
    'openings_length' => 5000,
    'access_road_width' => 50,
    'utilities_distance' => 50000,
    'construction_on_land' => true,
    'land_utr' => '<string>',
    'land_height_max' => 250,
    'land_width' => 50000,
    'land_length' => 50000,
    'surface_display' => 500000,
    'finishing' => '<string>',
    'technical_details' => '<string>',
    'nearby' => '<string>',
    'available_from_note' => '<string>',
    'commission_note' => '<string>',
    'commission_percent' => 10,
    'commission_vat' => true,
    'available_from' => '2023-12-25',
    'retired_floors' => 25,
    'lockers_count' => 500,
    'negotiable' => true,
    'historical_monument' => true,
    'property_for_investment' => true,
    'delivery_quarter' => 2,
    'delivery_year' => 2018,
    'sections_count' => 20,
    'reg_s' => 10,
    'reg_d' => 0,
    'reg_p' => 0,
    'reg_e' => 100,
    'phases_count' => 10,
    'unit_types' => [
        [
                'label' => '<string>',
                'floors' => '<string>',
                'area_sqm' => 5000.5,
                'area_sqm_to' => 5000.5,
                'units_count' => 5000,
                'price_from' => 500000000,
                'rooms' => 10
        ]
    ],
    'features' => [
        '<string>'
    ],
    'pet_friendly' => true,
    'media_links' => [
        'video' => '<string>',
        'tour' => '<string>',
        'plan' => '<string>'
    ],
    'photo_keys' => [
        '<string>'
    ],
    'photo_meta' => [
        [
                'floor' => '<string>',
                'rooms' => [
                                '<string>'
                ]
        ]
    ],
    'idempotency_key' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: '<string>',
    description: '<string>',
    city: '<string>',
    street: '<string>',
    latitude: 0,
    longitude: 0,
    contact_name: '<string>',
    contact_phone: '<string>',
    contact_email: 'jsmith@example.com',
    content_locale: '<string>',
    county: '<string>',
    country: '<string>',
    area: '<string>',
    address: '<string>',
    street_number: '<string>',
    street_manual: true,
    landmark: '<string>',
    rooms: 20,
    bedrooms: 15,
    bathrooms: 250,
    floor: '<string>',
    total_floors: 30,
    usable_area_sqm: 250000.5,
    built_area_sqm: 250000.5,
    land_area_sqm: 5000000.5,
    year_built: 1514,
    price: 500000000000,
    price_currency: '<string>',
    deposit_months: 1,
    deposit_amount: 500000000000,
    no_commission: true,
    utilities_included: true,
    accepts_trade: true,
    trade_accepts: [],
    trade_other: '<string>',
    heating_types: ['<string>'],
    materials: [''],
    flood_risk: true,
    underground_levels: [],
    parcel: [[123]],
    land_frontage: 5000,
    pot: 50,
    cut: 10,
    clearance_height: 50,
    power_capacity: 50000,
    floor_load_capacity: 50000,
    dock_doors_count: 250,
    orientations: [],
    parking_spots: 2500,
    balconies: 10,
    terraces: 10,
    kitchens: 25,
    garages: 25,
    lifts: 25,
    underground_floors: 5,
    interior_height: 50,
    renovated_year: 1514,
    apartments_count: 2500,
    energy_consumption: 2500,
    energy_renewable: 2500,
    emission_index: 500,
    shopfront_width: 500,
    occupancy_rate: 50,
    maintenance_cost: 50000,
    upfront_cost: 500000000,
    upfront_percent: 99,
    parking_surface_cost: 500000,
    parking_underground_cost: 500000,
    surface_total: 500000,
    surface_balconies: 500000,
    surface_terrace: 500000,
    surface_yard: 500000,
    surface_office: 500000,
    surface_office_available: 500000,
    surface_office_minimum: 500000,
    surface_production: 500000,
    surface_storage: 500000,
    footprint: 500000,
    street_openings: 10,
    openings_length: 5000,
    access_road_width: 50,
    utilities_distance: 50000,
    construction_on_land: true,
    land_utr: '<string>',
    land_height_max: 250,
    land_width: 50000,
    land_length: 50000,
    surface_display: 500000,
    finishing: '<string>',
    technical_details: '<string>',
    nearby: '<string>',
    available_from_note: '<string>',
    commission_note: '<string>',
    commission_percent: 10,
    commission_vat: true,
    available_from: '2023-12-25',
    retired_floors: 25,
    lockers_count: 500,
    negotiable: true,
    historical_monument: true,
    property_for_investment: true,
    delivery_quarter: 2,
    delivery_year: 2018,
    sections_count: 20,
    reg_s: 10,
    reg_d: 0,
    reg_p: 0,
    reg_e: 100,
    phases_count: 10,
    unit_types: [
      {
        label: '<string>',
        floors: '<string>',
        area_sqm: 5000.5,
        area_sqm_to: 5000.5,
        units_count: 5000,
        price_from: 500000000,
        rooms: 10
      }
    ],
    features: ['<string>'],
    pet_friendly: true,
    media_links: {video: '<string>', tour: '<string>', plan: '<string>'},
    photo_keys: ['<string>'],
    photo_meta: [{floor: '<string>', rooms: ['<string>']}],
    idempotency_key: '<string>'
  })
};

fetch('https://staging.housera.ro/api/v1/listings/validate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://staging.housera.ro/api/v1/listings/validate"

payload = {
    "title": "<string>",
    "description": "<string>",
    "city": "<string>",
    "street": "<string>",
    "latitude": 0,
    "longitude": 0,
    "contact_name": "<string>",
    "contact_phone": "<string>",
    "contact_email": "jsmith@example.com",
    "content_locale": "<string>",
    "county": "<string>",
    "country": "<string>",
    "area": "<string>",
    "address": "<string>",
    "street_number": "<string>",
    "street_manual": True,
    "landmark": "<string>",
    "rooms": 20,
    "bedrooms": 15,
    "bathrooms": 250,
    "floor": "<string>",
    "total_floors": 30,
    "usable_area_sqm": 250000.5,
    "built_area_sqm": 250000.5,
    "land_area_sqm": 5000000.5,
    "year_built": 1514,
    "price": 500000000000,
    "price_currency": "<string>",
    "deposit_months": 1,
    "deposit_amount": 500000000000,
    "no_commission": True,
    "utilities_included": True,
    "accepts_trade": True,
    "trade_accepts": [],
    "trade_other": "<string>",
    "heating_types": ["<string>"],
    "materials": [""],
    "flood_risk": True,
    "underground_levels": [],
    "parcel": [[123]],
    "land_frontage": 5000,
    "pot": 50,
    "cut": 10,
    "clearance_height": 50,
    "power_capacity": 50000,
    "floor_load_capacity": 50000,
    "dock_doors_count": 250,
    "orientations": [],
    "parking_spots": 2500,
    "balconies": 10,
    "terraces": 10,
    "kitchens": 25,
    "garages": 25,
    "lifts": 25,
    "underground_floors": 5,
    "interior_height": 50,
    "renovated_year": 1514,
    "apartments_count": 2500,
    "energy_consumption": 2500,
    "energy_renewable": 2500,
    "emission_index": 500,
    "shopfront_width": 500,
    "occupancy_rate": 50,
    "maintenance_cost": 50000,
    "upfront_cost": 500000000,
    "upfront_percent": 99,
    "parking_surface_cost": 500000,
    "parking_underground_cost": 500000,
    "surface_total": 500000,
    "surface_balconies": 500000,
    "surface_terrace": 500000,
    "surface_yard": 500000,
    "surface_office": 500000,
    "surface_office_available": 500000,
    "surface_office_minimum": 500000,
    "surface_production": 500000,
    "surface_storage": 500000,
    "footprint": 500000,
    "street_openings": 10,
    "openings_length": 5000,
    "access_road_width": 50,
    "utilities_distance": 50000,
    "construction_on_land": True,
    "land_utr": "<string>",
    "land_height_max": 250,
    "land_width": 50000,
    "land_length": 50000,
    "surface_display": 500000,
    "finishing": "<string>",
    "technical_details": "<string>",
    "nearby": "<string>",
    "available_from_note": "<string>",
    "commission_note": "<string>",
    "commission_percent": 10,
    "commission_vat": True,
    "available_from": "2023-12-25",
    "retired_floors": 25,
    "lockers_count": 500,
    "negotiable": True,
    "historical_monument": True,
    "property_for_investment": True,
    "delivery_quarter": 2,
    "delivery_year": 2018,
    "sections_count": 20,
    "reg_s": 10,
    "reg_d": 0,
    "reg_p": 0,
    "reg_e": 100,
    "phases_count": 10,
    "unit_types": [
        {
            "label": "<string>",
            "floors": "<string>",
            "area_sqm": 5000.5,
            "area_sqm_to": 5000.5,
            "units_count": 5000,
            "price_from": 500000000,
            "rooms": 10
        }
    ],
    "features": ["<string>"],
    "pet_friendly": True,
    "media_links": {
        "video": "<string>",
        "tour": "<string>",
        "plan": "<string>"
    },
    "photo_keys": ["<string>"],
    "photo_meta": [
        {
            "floor": "<string>",
            "rooms": ["<string>"]
        }
    ],
    "idempotency_key": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "valid": true
}

Authorizations

Authorization

string

header

required

Authorization: Bearer

Body

application/json

type

enum<string>

required

Property type.

Available options:

apartment,

house,

room,

complex,

land,

commercial,

warehouse,

garage,

hospitality,

special

transaction

enum<string>

required

Transaction type.

Available options:

sale,

rent

title

string

required

Title.

Required string length: 10 - 90

description

string

required

Description.

Required string length: 30 - 5000

city

string

required

City.

Maximum string length: 120

street

string

required

Street.

Maximum string length: 255

latitude

number

required

Latitude.

Required range: -90 <= x <= 90

longitude

number

required

Longitude.

Required range: -180 <= x <= 180

contact_name

string

required

Contact name.

Maximum string length: 255

contact_phone

string

required

Contact phone.

Maximum string length: 25

contact_email

string<email>

required

Contact email.

Maximum string length: 255

subtype

enum<string> | null

Subtype.

Available options:

null

content_locale

string | null

The language of the title and description (ISO 639-1, e.g. ro).

Pattern: ^[a-zA-Z]{2}$

county

string | null

County.

Maximum string length: 120

country

string | null

Country.

area

string | null

Neighbourhood.

Maximum string length: 120

address

string | null

Address.

Maximum string length: 255

street_number

string | null

Street number.

Maximum string length: 32

street_manual

boolean | null

Street provenance.

landmark

string | null

Landmark.

Maximum string length: 120

rooms

integer | null

Number of rooms.

Required range: 1 <= x <= 40

bedrooms

integer | null

Number of bedrooms.

Required range: 0 <= x <= 30

bathrooms

integer | null

Number of bathrooms.

Required range: 0 <= x <= 500

floor

string | null

Floor.

total_floors

integer | null

Total number of floors.

Required range: 0 <= x <= 60

usable_area_sqm

number | null

Usable area.

Required range: 1 <= x <= 500000

built_area_sqm

number | null

Built area.

Required range: 1 <= x <= 500000

land_area_sqm

number | null

Land area.

Required range: 1 <= x <= 10000000

year_built

integer | null

Year built.

Required range: 1000 <= x <= 2029

price

integer | null

Price.

Required range: 1 <= x <= 1000000000000

price_currency

string | null

The currency of the submitted price, ISO 4217 code (EUR, RON or another currency from the reference exchange rate; the list is in /schema). The search compares the price converted to euros.

Pattern: ^[A-Z]{3}$

deposit_months

integer | null

Months of deposit.

Required range: 0 <= x <= 3

deposit_amount

integer | null

The required deposit, in the price currency.

Required range: 0 <= x <= 1000000000000

no_commission

boolean | null

No commission.

utilities_included

boolean | null

Utilities included.

accepts_trade

boolean | null

Trade accepted.

trade_accepts

enum<string>[] | null

What is accepted in trade.

Maximum array length: 4

Available options:

similar_property,

other_type,

vehicle,

other

trade_other

string | null

Other trade type.

Maximum string length: 120

trade_price_diff

enum<string> | null

Trade price difference.

Available options:

none,

owner_pays,

owner_gets,

both

heating_types

string[] | null

Heating types.

Maximum array length: 12

Maximum string length: 32

condition

enum<string> | null

Condition.

Available options:

new,

renovated,

good,

needs_renovation,

to_demolish

furnished

enum<string> | null

Furnishing.

Available options:

furnished,

partially_furnished,

unfurnished

energy_certificate

enum<string> | null

Energy certificate.

Available options:

a_plus,

a0,

a,

b,

c,

d,

e,

f,

g

energy_certificate_status

enum<string> | null

The status of the energy certificate: available (exists), preliminary (in the process of being issued) or exempt (the building is exempt).

Available options:

available,

preliminary,

exempt

materials

enum<string>[] | null

Construction materials.

Maximum array length: 2

Available options:

windows

enum<string> | null

Windows.

Available options:

pvc_thermal,

triple_glazing,

wood_thermal,

aluminium,

classic_wood

roof

enum<string> | null

Roof.

Available options:

tile,

metal,

terrace,

shingle

access

enum<string> | null

Access.

Available options:

asphalt,

gravel,

dirt,

private

attic

enum<string> | null

Attic.

Available options:

attic,

roof_space,

none

flood_risk

boolean | null

Flood risk.

underground_levels

enum<string>[] | null

Number of underground levels.

Maximum array length: 2

Available options:

semi_basement,

basement

parcel

number[][] | null

Parcel.

Required array length: 3 - 500 elements

Required array length: 2 elements

land_classification

enum<string> | null

Land classification.

Available options:

inside_built_up_area,

outside_built_up_area

land_frontage

integer | null

Street frontage.

Required range: 1 <= x <= 10000

pot

number | null

Planning certificate.

Required range: 0 <= x <= 100

cut

number | null

Layout.

Required range: 0 <= x <= 20

clearance_height

number | null

Clearance height.

Required range: 0 <= x <= 100

power_capacity

integer | null

Power capacity.

Required range: 1 <= x <= 100000

floor_load_capacity

integer | null

Floor load capacity.

Required range: 1 <= x <= 100000

dock_doors_count

integer | null

Number of dock doors.

Required range: 0 <= x <= 500

building_type

enum<string> | null

Building type.

Available options:

apartment_block,

house,

studio_block,

mixed

construction_status

enum<string> | null

Construction status.

Available options:

finished,

semi_finished,

under_construction,

grey,

red,

structure,

project

comfort

enum<string> | null

Comfort class.

Available options:

first,

second,

third,

luxury

orientations

enum<string>[] | null

The orientations (up to 4).

Maximum array length: 4

Available options:

north,

north_east,

east,

south_east,

south,

south_west,

west,

north_west

seismic_risk

enum<string> | null

Seismic risk.

Available options:

emergency,

class_1,

class_2,

class_3

road_type

enum<string> | null

Road access.

Available options:

street,

main_road,

national_road,

highway,

ring_road,

lake,

forest,

easement

pedestrian_traffic

enum<string> | null

Pedestrian traffic.

Available options:

heavy,

moderate,

none

parking_spots

integer | null

Number of parking spots.

Required range: 0 <= x <= 5000

balconies

integer | null

Number of balconies.

Required range: 0 <= x <= 20

terraces

integer | null

Number of terraces.

Required range: 0 <= x <= 20

kitchens

integer | null

Number of kitchens.

Required range: 0 <= x <= 50

garages

integer | null

Number of garages.

Required range: 0 <= x <= 50

lifts

integer | null

Number of lifts.

Required range: 0 <= x <= 50

underground_floors

integer | null

Number of underground floors.

Required range: 0 <= x <= 10

interior_height

number | null

Interior height.

Required range: 0 <= x <= 100

renovated_year

integer | null

Renovation year.

Required range: 1000 <= x <= 2029

apartments_count

integer | null

Number of apartments.

Required range: 1 <= x <= 5000

energy_consumption

number | null

Energy consumption.

Required range: 0 <= x <= 5000

energy_renewable

number | null

Renewable energy consumption.

Required range: 0 <= x <= 5000

emission_index

number | null

Emission index.

Required range: 0 <= x <= 1000

shopfront_width

number | null

Shopfront width.

Required range: 0 <= x <= 1000

occupancy_rate

integer | null

Occupancy rate.

Required range: 0 <= x <= 100

maintenance_cost

integer | null

Maintenance cost.

Required range: 0 <= x <= 100000

upfront_cost

integer | null

Down payment.

Required range: 0 <= x <= 1000000000

upfront_percent

number | null

Down payment percentage.

Required range: x <= 100

parking_surface_cost

integer | null

Surface parking spot cost.

Required range: 0 <= x <= 1000000

parking_underground_cost

integer | null

Underground parking spot cost.

Required range: 0 <= x <= 1000000

surface_total

number | null

Total surface.

Required range: 0 <= x <= 1000000

surface_balconies

number | null

Balconies surface.

Required range: 0 <= x <= 1000000

surface_terrace

number | null

Terrace surface.

Required range: 0 <= x <= 1000000

surface_yard

number | null

Yard surface.

Required range: 0 <= x <= 1000000

surface_office

number | null

Total office surface.

Required range: 0 <= x <= 1000000

surface_office_available

number | null

Maximum available surface.

Required range: 0 <= x <= 1000000

surface_office_minimum

number | null

Minimum rentable surface.

Required range: 0 <= x <= 1000000

surface_production

number | null

Production surface.

Required range: 0 <= x <= 1000000

surface_storage

number | null

Storage surface.

Required range: 0 <= x <= 1000000

footprint

number | null

Footprint.

Required range: 0 <= x <= 1000000

street_openings

integer | null

Number of street fronts.

Required range: 0 <= x <= 20

openings_length

number | null

Frontage length.

Required range: 0 <= x <= 10000

access_road_width

number | null

Access road width.

Required range: 0 <= x <= 100

utilities_distance

integer | null

Distance to utilities.

Required range: 0 <= x <= 100000

construction_on_land

boolean | null

Construction on the plot.

land_utr

string | null

UTR.

Maximum string length: 40

land_height_max

number | null

Maximum permitted height.

Required range: 0 <= x <= 500

land_width

number | null

Plot width.

Required range: 0 <= x <= 100000

land_length

number | null

Plot length.

Required range: 0 <= x <= 100000

surface_display

number | null

Display surface.

Required range: 0 <= x <= 1000000

finishing

string | null

Finishes.

Maximum string length: 5000

technical_details

string | null

Technical details.

Maximum string length: 5000

nearby

string | null

Surroundings.

Maximum string length: 5000

available_from_note

string | null

Availability.

Maximum string length: 60

commission_note

string | null

Commission asked.

Maximum string length: 60

commission_percent

number | null

Commission percentage.

Required range: 0 <= x <= 20

commission_vat

boolean | null

VAT on the commission.

price_vat

enum<string> | null

VAT on the price.

Available options:

included,

plus,

none

available_from

string<date> | null

Availability date.

retired_floors

integer | null

Number of set-back floors.

Required range: 0 <= x <= 50

lockers_count

integer | null

Number of locker rooms.

Required range: 0 <= x <= 1000

negotiable

boolean | null

Negotiable price.

historical_monument

boolean | null

Historic monument.

property_for_investment

boolean | null

Investment suitability.

garage_position

enum<string> | null

Garage position.

Available options:

underground,

aboveground

bathroom_type

enum<string> | null

Bathroom type.

Available options:

private,

shared

roommate_preference

enum<string> | null

Roommate preference.

Available options:

any,

female,

male

commercial_class

enum<string> | null

Space class.

Available options:

a,

b,

c

commercial_layout

enum<string> | null

Space layout.

Available options:

open_space,

separate_offices,

railroad,

flexible

partitioning

enum<string> | null

Partitioning.

Available options:

detached,

semi_detached,

undetached,

circular,

railroad,

unknown

complex_mode

enum<string> | null

Complex type.

Available options:

blocks,

houses,

offices

project_stage

enum<string> | null

Project stage.

Available options:

under_construction,

finished,

mixed

delivery_quarter

integer | null

Delivery quarter.

Required range: 1 <= x <= 4

delivery_year

integer | null

Delivery year.

Required range: 2000 <= x <= 2036

sections_count

integer | null

Number of sections.

Required range: 1 <= x <= 40

reg_s

integer | null

Height regime (S).

Required range: 0 <= x <= 20

reg_d

integer | null

Height regime (D).

Required range: 0 <= x <= 1

reg_p

integer | null

Height regime (P).

Required range: 0 <= x <= 1

reg_e

integer | null

Height regime (E).

Required range: 0 <= x <= 200

top_level

enum<string> | null

Top level.

Available options:

none,

attic,

roof_space

phases_count

integer | null

Number of phases.

Required range: 1 <= x <= 20

house_regime

enum<string> | null

House regime.

Available options:

ground,

ground_plus_1,

ground_plus_1_attic,

ground_plus_2

unit_types

object[] | null

Unit types.

Maximum array length: 50

Show child attributes

features

string[] | null

Features.

Maximum array length: 328

Maximum string length: 64

pet_friendly

boolean

Pets allowed.

media_links

object

The media links of the listing.

Show child attributes

photo_keys

string[] | null

Photo keys.

Maximum array length: 100

Maximum string length: 255

photo_meta

object[] | null

Photo data.

Maximum array length: 100

Show child attributes

idempotency_key

string | null

Idempotency key.

Maximum string length: 64

contact_as

enum<string> | null

Contact role.

Available options:

owner,

agent,

developer

Response

Successful.

valid

boolean

required

true: the listing passes all publishing rules.

Start

Concepts

Guides

Reference

More

Validate a listing

Authorizations

Body

Response