ingest

Crear o actualizar una propiedad

Requiere key con scope write. No publica directo: aterriza en staging y pasa por las puertas de validación antes de aparecer en las búsquedas.

put/properties/{listingKey}

Request

  • Base URL: https://api.inmo.example/v1
  • URL: https://api.inmo.example/v1/properties/{listingKey}
  • Auth: HTTP bearer

Request body

listingIdstring
transactionType'ForSale' | 'ForLease' required

Conveniencia derivada de PropertyType para la superficie REST/agentes. No es un campo RESO; RESO lo expresa dentro de PropertyType.

propertyType'Residential' | 'Residential Lease' | 'Residential Income' | 'Commercial Sale' | 'Commercial Lease' | 'Business Opportunity' | 'Land' | 'Farm' | 'Manufactured In Park' required

RESO PropertyType — lookup oficial. En RESO la transacción (venta/renta) ya está codificada en el tipo (p. ej. Residential Lease). transactionType es una conveniencia derivada, no reemplaza a este campo.

propertySubType'Single Family Residence' | 'Condominium' | 'Townhouse' | 'Apartment' | 'Duplex' | 'Multi Family' | 'Manufactured Home' | 'Mobile Home' | 'Cabin' | 'Ranch' | 'Unimproved Land' | 'Office' | 'Retail' | 'Warehouse' | 'Other'

RESO PropertySubType — lookup oficial (subconjunto de uso común en MX).

listPricenumber required
listPriceCurrencystring required
bedroomsTotalinteger
bathroomsTotalIntegerinteger
livingAreanumber
livingAreaUnits'SquareMeters' | 'SquareFeet'

RESO LivingAreaUnits. Obligatorio si hay área; nunca asumir.

publicRemarksstring
latitudenumber
longitudenumber
unparsedAddressstring
postalCodestring
citystring
stateOrProvincestring
sourceUrlstring uri

Example request

{
  "listPriceCurrency": "MXN"
}

Response

Aceptada en staging; pendiente de validación.

receivedinteger
acceptedToStaginginteger
rejectedinteger

Example response

{
  "rejections": [
    {
      "gate": "geocode"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.