📘
El endpoint lo encuentras en el apartado Properties en la referencia de nuestra API.

Cómo consultar los detalles de una propiedad

Para obtener los detalles de una propiedad deberás usar este endpoint con el public_id de la propiedad que obtuviste en Listing Statuses.

En este ejemplo pedimos el detalle de la propiedad con public_id: EB-B0579

curl --request GET \
     --url https://api.easybroker.com/v1/integration_partners/properties/EB-B0579 \
     --header 'Country-Code: MX' \
     --header 'X-Authorization: $API_KEY' \
     --header 'accept: application/json'

Y en el resultado obtendrás todos los detalles de la propiedad, incluyendo fotografías, descripción, tipo de operación, características, amenidades, etc.

Es importante que sepas que incluye los datos de contacto de la agencia o del agente asignado, ese tema lo verás en el siguiente punto.

Este es un ejemplo de la respuesta que podrías recibir:

{
  "public_id": "EB-B0579",
  "title": "Bosques de las Lomas, departamento a la renta en Residencial",
  "created_at": "2018-06-22T18:27:33-05:00",
  "updated_at": "2024-04-09T22:00:35-06:00",
  "url": "https://www.easybroker.com/mx/listings/7425-mcv-casa-en-venta-en-tenayuca-letran-valle-benito-juarez",
  "description": "Bosques de las Loma, departamento a la renta en Residencial Solarium . Cuenta con 325 mts, sala, comedor, cocina, desayunador, estudio, 3 recamaras con baño y vestidor, cuarto de lavado y servicio, mantenimiento incluido, 2 estacionamientos. Amenidades: gimnasio, elevador de servicio, sala de juegos, seguridad, spa, alberca, apto mascotas, circuito errado, juegos para niños, ludoteca, salón de fiestas, seguridad 24hs.\n\n_____________________________________________________\n\n \nLas medidas son ilustrativas y deben de corroborarse con los títulos de propiedad respectivos y/o las boletas predial. \nLos precios publicados y la disponibilidad pueden cambiar sin previo aviso por lo que se debe de verificar con la inmobiliaria y los propietarios de los inmuebles. \nLa publicación de la presente información No representa una oferta pública por lo que toda transacción debe de hacerse de forma personal de acuerdo a las practicas comerciales de la inmobiliaria y para poder ser valida requiere de la autorización expresa de los propietarios de los inmuebles. EasyBroker ID: EB-B0579",
  "property_type": "Departamento",
  "bedrooms": 3,
  "bathrooms": 3,
  "half_bathrooms": 1,
  "parking_spaces": 4,
  "lot_size": 0,
  "construction_size": 325,
  "expenses": "0",
  "lot_length": 0,
  "lot_width": 0,
  "floors": null,
  "floor": "1",
  "age": "1998",
  "agency_id": "1204",
  "agent_id": "edi_3",
  "location": {
    "region": "Ciudad de México",
    "city": "Benito Juárez",
    "city_area": "Del Valle Centro",
    "street": "Magdalena",
    "postal_code": null,
    "show_exact_location": true,
    "latitude": 19.3973722,
    "longitude": -99.1702142
  },
  "operations": [
    {
      "type": "sale",
      "amount": 1000883,
      "currency": "MXN",
      "formatted_amount": "$1,000,883",
      "unit": "total"
    }
  ],
  "videos": [
    "https://www.youtube.com/watch?v=vv_uy0miZgI"
  ],
  "virtual_tour": "https://my.matterport.com/show/?m=4dgjzfwSHG2",
  "features": [
    "Elevador",
    "Estacionamiento techado",
    "Gimnasio",
    "Seguridad 24 Horas",
    "Cocina integral",
    "Alberca",
    "Alberca Automática",
    "Salón de usos múltiples"
  ],
  "tags": [
    "publicadas"
  ],
  "ad_type": null,
  "property_images": [
    {
      "title": null,
      "url": "https://assets.stagingeb.com/property_images/20579/317458/EB-B0579.png?version=1666736750"
    },
    {
      "title": null,
      "url": "https://assets.stagingeb.com/property_images/20579/401196/EB-B0579.jpg?version=1692035838"
    },
    ...
    {
      "title": null,
      "url": "https://assets.stagingeb.com/property_images/20579/401209/EB-B0579.jpg?version=1692035848"
    }
  ]
}

Datos de contacto

En la respuesta de ejemplo encontrarás dos campos que te ayudarán a obtener los datos de contacto de la propiedad.

agency_id: Contiene el ID único de la agencia y que deberás usar para obtener sus datos de contacto usando el endpoint de Agencies.
agent_id: Contiene el ID único del agente y para obtener los datos de contacto del agente deberás usar el endpoint de Agents.

Escenarios posibles

Existen dos escenarios posibles a la hora de consultar los detalles de una propiedad, estos dependerán de acuerdo a las preferencias de la agencia y pueden cambiar cada vez que ellos lo decidan.

El primero es cuando una propiedad no está asignada a un agente, en este caso solo recibirás el ID de la agencia y lo verás en la respuesta de esta forma.
```
"agency_id": "1204",
"agent_id": "null"
```
Para este caso solo será necesario que consultes el endpoint Agencies.
El segundo es cuando una propiedad sí tiene un agente asignado. Recibirás ambos IDs, el de la agencia y el del agente.
```
"agency_id": "1204",
"agent_id": "null"
```
En este caso será necesario que consultes al endpoint de Agents.

📘
Recuerda, te recomendamos relacionar esta información usando el agency_id.