GET /api/action/portal-v2/properties/{propertyHash}

PROD

Este servicio devuelve el detalle de una propiedad.

Información del recurso
Autenticación	Required
Scope	`internal-portal`
Método HTTP	GET
Respuesta	JSON
Versión	2

Alcance de red

Si tu cliente tiene el scope network-suscription, la propiedad debe pertenecer a un cliente de tu red. Las propiedades fuera de tu red devuelven un error de no encontrado, incluso si el hash es válido.

URL del recurso

https://mapaprop.app/api/action/portal-v2/properties/{propertyHash}

Ejemplo de llamada

GET /api/action/portal-v2/properties/YoJEWd1x4qvlpGw HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}

Parámetros

Clave	Tipo	Requerido	Descripción
propertyHash	string	yes	El Hash ID de la propiedad

Respuesta

Un documento JSON con el detalle de la propiedad.

Objeto	Campo	Tipo	Requerido	Descripción
Response	property	Property object	yes	El objeto propiedad
Property	propertyHash	string	yes	ID único de la propiedad
	timestamp	string	yes	Timestamp ISO8601 de cuándo se creó la propiedad
	lastUpdate	string	yes	Timestamp ISO8601 de la última actualización
	code	string	yes	Código único de la propiedad ingresado por el cliente
	branchId	int	yes	ID de la sucursal asociada a la propiedad. GET /api/action/express-v1/branches.
	type	int	yes	Tipo de propiedad. GET /api/action/portal-v2/settings/types/{country}
	propertyType	string	yes	Descripción traducida del tipo de propiedad. GET /api/action/portal-v2/settings/types/{country}
	operation	int	yes	Operación de la propiedad. GET /api/action/portal-v2/settings/operations/{country}
	propertyOperation	string	yes	Descripción traducida de la operación. GET /api/action/portal-v2/settings/operations/{country}
	status	int	yes	ID del estado edilicio. Constantes
	mainImage	string	no	URL del thumbnail principal de la propiedad
	currency	string	yes	Símbolo de moneda del precio. Constantes
	price	int	yes	Precio de la propiedad
	expensesCurrencies	string	no	Símbolo de moneda de las expensas. Constantes
	expensesPrice	int	no	Monto de las expensas mensuales / anuales
	taxCurrency	string	no	Símbolo de moneda de los impuestos. Constantes
	taxPrice	int	no	Monto de los impuestos mensuales / anuales
	title	string	yes	Título ingresado por el cliente
	address	string	yes	Calle y número de la propiedad
	zipCode	string	yes	Código postal de la ubicación
	zone	string	yes	Descripción amigable que combina ciudad (si está disponible) y provincia
	countryId	int	yes	ID del país de la propiedad
	stateId	int	yes	ID de la provincia. GET /api/action/express-v1/zones
	countyId	int	yes	ID del partido / condado. GET /api/action/express-v1/zones
	cityId	int	no	ID de la ciudad. GET /api/action/express-v1/zones
	countryId	int	yes	ID del país de la propiedad. GET /api/action/express-v1/zones
	country	string	yes	Nombre del país
	state	string	yes	Nombre de la provincia
	county	string	yes	Nombre del partido o segunda división
	city	string	no	Nombre de la ciudad / barrio o tercera división
	suspended	boolean	yes	La publicación fue suspendida
	reserved	boolean	yes	La propiedad fue reservada
	rented	boolean	yes	La propiedad fue alquilada
	sold	boolean	yes	La propiedad fue vendida
	description	string	yes	Descripción larga de la propiedad
	conditions	string	no	Condiciones de la propiedad. Generalmente relacionadas con el pago
	bedrooms	int	no	Cantidad de dormitorios
	ambiences	int	no	Cantidad de ambientes
	bathrooms	int	no	Cantidad de baños
	dependencies	int	no	Cantidad de dependencias (cuartos extra)
	occupancy	int	no	Cantidad de ocupantes (generalmente para alquiler temporal)
	toilettes	int	no	Cantidad de toilettes (medios baños)
	buildingArea	int	no	Metros cuadrados de superficie cubierta
	landArea	int	no	Metros cuadrados de terreno
	yearsOld	int	no	Antigüedad de la propiedad
	ubication	string	no	Orientación cardinal de la propiedad en el edificio
	totalFloors	int	no	Total de pisos del edificio
	apartmentsPerFloor	int	no	Cantidad de departamentos por piso
	airConditionerType	string	no	Tipo de aire acondicionado
	waterHeaterType	string	no	Tipo de calefón
	heatingType	string	no	Tipo de calefacción
	balconyType	string	no	Tipo de balcón
	garage	int	no	Cantidad de garajes de la propiedad
	garageType	string	no	Tipo de garage
	images	Array of Image	no	Array de objetos Image
	location	Location	yes	Objeto de ubicación geográfica
Location	lon	string	yes	Longitud de la propiedad
	lat	string	yes	Latitud de la propiedad
Image	image	string	yes	URL de la imagen
	thumbnail	string	yes	URL del thumbnail
	orientation	int	yes	Orientación de la imagen. 1 = PORTRAIT, 2 = LANDSCAPE
	type	int	yes	Tipo de imagen.
1 = PHOTO,
2 = BLUEPRINT
	contentType	string	yes	Tipo de contenido de la imagen
	timestamp	string	yes	Timestamp ISO8601 de cuando se subió la imagen
branch	Branch Data	Array of info	yes	Lista de datos de la sucursal del agente
	zip	string	yes
	zone0Description	string	yes
	zone1Description	string	yes
	zone2Description	string	yes
	zone3Description	string	no
	zone0	int	yes
	zone1	int	yes
	zone2	int	yes
	zone3	int	no
	address	string	yes
	phone1	string	yes
	phone2	string	no
	phone3	string	no
	mobile	string	no
	main	boolean	yes
	name	string	yes
	email	string	yes
	customer	string	yes
Labels	labels	Array of labels	no	Etiquetas / amenidades de la propiedad - Constantes
customer	customerAddress	string	yes
	customerCountry	int	yes
	customerEmail	string	yes
	customerId	int	yes
	customerlogo	string	yes
	customerName	string	yes
	customerPhone	string	yes
attributes	attributes	Array of json attributes	no	Todos los atributos de la propiedad
descriptionFormatted	description	string	no	Descripción con nuevo formato que acepta saltos de línea
videos	videos	Array of json	no	Videos de la propiedad (URL o embed)

Ejemplo de respuesta

{
  "property": {
      "country": "Argentina",
      "heatingType": "Estufas",
      "occupancy": 2,
      "waterHeaterType": "Termotanque",
      "landArea": 200,
      "county": "Chilecito",
      "buildingArea": 120,
      "ubication": "Lateral",
      "cityId": 4011,
      "type": "1",
      "propertyType": "Departamento",
      "apartmentsPerFloor": 3,
      "zone": "Colonia Malligasta, Chilecito, La Rioja, Argentina",
      "price": 2500,
      "airConditionerType": "Split/Ventana",
      "state": "La Rioja",
      "branchId": 23443,
       "videos": [
        {
            "custId": 1,
            "description": "asdasdsadadasd",
            "videoId": 7252,
            "source": "https://www.youtube.com/shorts/DV5mG3XGPZU",
            "propertyId": 256854
        },
        {
            "custId": 1,
            "description": "asdasdsadadasd",
            "videoId": 7253,
            "source": "https://www.youtube.com/watch?v=gLcP6qqulhA&ab_channel=NovalProperties",
            "propertyId": 256854
        },
        {
            "custId": 1,
            "description": "asdasdsadadasd",
            "videoId": 7254,
            "source": "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/gLcP6qqulhA?si=CpKaYWLYZXXh4zyP\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen></iframe>",
            "propertyId": 256854
        },
        {
            "custId": 1,
            "description": "dasdsadsss",
            "videoId": 7258,
            "source": "https://my.matterport.com/show?play=1&lang=en-US&m=CmhKN1eSdqR",
            "propertyId": 256854
        }
    ],
      "branch": {
        "zip": "1878",
        "zone2Description": "Quilmes",
        "branchId": 7914,
        "address": "Lavalle 654 ",
        "phone2": "11-0000-0000",
        "main": true,
        "zone0Description": "Argentina",
        "zone3": 1098,
        "zone2": 237,
        "zone1": 2,
        "zone0": 1,
        "phone1": "7078-0000",
                "mobile": "541144440000"
        "zone1Description": "Buenos Aires",
        "custId": 7466,
        "name": "Gabriel Bagnato Bienes Ra?ces",
        "zone3Description": "Quilmes",
        "email": "xxxxx@gmail.com",
        "customer": "Ruben Inmobiliaria"
    },
      "images": [
        {
          "image": "https://s3.amazonaws.com/mapaprop-dev/photos/2342/92478/755270.jpg",
          "thumbnail": "https://s3.amazonaws.com/mapaprop-dev/photos/234/92478/755270t.jpg",
          "orientation": 1,
          "imageId": 234432,
          "main": true,
          "type": 1,
          "contentType": "image/jpeg",
          "timestamp": "2015-11-18T22:47:53Z"
        },
        {
          "image": "https://s3.amazonaws.com/mapaprop-dev/photos/234/9242348/755271.jpg",
          "thumbnail": "https://s3.amazonaws.com/mapaprop-dev/photos/1687/2/34755271t.jpg",
          "orientation": 2,
          "imageId": 234,
          "main": false,
          "type": 1,
          "contentType": "image/jpeg",
          "timestamp": "2015-11-18T22:48:23Z"
        }
      ],
      "bathrooms": 1,
      "suspended": false,
      "dependencies": 3,
      "labels": [
        "mortgageReady",
        "professionalAvailable",
        "furnished",
        "janitor",
        "grill",
        "security",
        "securityBox",
        "swimmingPool",
        "partySaloon",
        "cableIncluded",
        "heating",
        "airConditioning",
        "telephoneLine",
        "dialyDinning",
        "alarm",
        "frontGarden",
        "garage",
        "laundry",
        "patio",
        "playroom",
        "privateElevator",
        "suite"
      ],
      "bedrooms": 2,
      "ambiences": 2,
      "balconyType": "Terraza",
      "yearsOld": 2,
      "reserved": false,
      "lastUpdate": "2017-11-01T06:40:40.000-04:00",
      "paymentPeriod": "Por mes",
      "conditions": "•\tAlquiler pago mes a mes. •\tDepósito de 1 mes de alquiler. •\tComisión inmobiliaria. ",
      "status": "A Refaccionar",
      "code": "1687-paunero.lasheras-102apt",
      "expensesCurrency": "USD",
      "city": "Colonia Malligasta",
      "description": "Muy luminoso departamento muy bien ubicado en Palermo - Gran balcón - Totalmente amoblado - Gran Sofa - Cocina completamente equipada - Cama grande - baño completo - Tv con Cable - Wifi - Todo INCLUIDO",
      "alternativePrices": [],
      "title": "Hermoso y muy Luminoso depto ubicado en Palermo",
      "totalFloors": 2,
      "countryId": 1,
      "toilettes": 2,
      "seoUrl": "alquiler-temporario-de-departamento-en-colonia-malligasta234-la-rioja-16e87-344",
      "rented": false,
      "expensesPrice": 322,
      "countyId": 561,
      "hightlight": {},
      "currency": "ARS",
      "timestamp": "2015-11-18T00:00:00.000-05:00",
      "sold": true,
      "orientation": "NORTE",
      "address": "Paunero ",
      "zipCode": "1661",
      "stateId": 12,
      "propertyHash": "9cd969ac3a4623sdffd2cfeea1abab7",
      "mainImage": "https://s3.amazonaws.com/mapaprop-dev/photos/32443/2434/755270t.jpg",
      "taxCurrency": "USD",
      "garage": 2,
      "garageType": "Garage Cubierto",
      "taxPrice": 329032,
      "location": {
        "lon": "-58.409215670639014",
        "lat": "-34.58256378363613"
      },
      "operation": "3",
      "propertyOperation": "Alquiler Temporario",
      "customerLogo": "https://s3.amazonaws.com/mapaprop-dev/photos/32443/2434/755270t.jpg",
      "customerAddress": "Malabia 3526",
      "customerCountry": 1,
      "customerEmail": "email@dominio.com",
      "customerId": 0000,
      "customerName": "Inmobiliaria X",
      "customerPhone": "111-111",
            "attributes": [
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "electricity",
                    "group_subtype": "services",
                    "id": "electricity",
                    "label": "Electricidad",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "grill",
                    "group_subtype": "ammenities",
                    "id": "grill",
                    "label": "Parrilla",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "laundryMachine",
                    "group_subtype": "ammenities",
                    "id": "laundry-machine",
                    "label": "Lavarropas",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "professionalAvailable",
                    "group_subtype": "extras",
                    "id": "professional-available",
                    "label": "Apto profesional",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "hasSecurity",
                    "group_subtype": "services",
                    "id": "security",
                    "label": "Seguridad",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "sewers",
                    "group_subtype": "services",
                    "id": "sewers",
                    "label": "Cloacas",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                }
          ],
        "descriptionFormatted": "Test Images, Propiedad TestTest Images, \n\nPropiedad Test",
    }
}