Este servicio devuelve la lista de desarrollos inmobiliarios de tu cuenta (la inmobiliaria dueña del token). El scope sale del access token, no se envía como parámetro.

URL del recurso

https://mapaprop.app/api/action/express-v1/developments

Código de ejemplo

GET /api/action/express-v1/developments?customerId=1&dateFrom=20-02-2019&dateTo=28-02-2019 HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}

Parámetros

Paginación

Este endpoint utiliza paginación por offset a través de los parámetros from y size.

La respuesta siempre incluye el campo total con el total de registros que coinciden con los filtros (no solo los de la página actual). Usá ese valor para saber cuándo dejar de paginar.

Cómo paginar

Para obtener la página N (índice 1) con un tamaño fijo de página:

from = (N - 1) * size

Seguí solicitando la siguiente página mientras from + size < total.

Ejemplo: paginar 25 desarrollos, 20 por página

Supongamos que una búsqueda devuelve "total": 25. Para obtener todos los resultados se necesitan 2 solicitudes:

Página 1 — registros 1 a 20:

GET /api/action/express-v1/developments?from=0&size=20

Respuesta: { "took": 8, "total": 25, "properties": [ ...20 items... ] }

Página 2 — registros 21 a 25:

GET /api/action/express-v1/developments?from=20&size=20

Respuesta: { "took": 6, "total": 25, "properties": [ ...5 items... ] }

En este punto from + size = 40 >= total = 25, por lo que no hay más páginas.

Notas

• Mantené los filtros consistentes entre páginas. Cambiar cualquier filtro entre solicitudes (por ejemplo operation, stateId, dateFrom) reinicia el conjunto de resultados y tu offset apuntará a una colección diferente.
• size no puede superar 20. Solicitar size=21 o más devuelve un error de validación: "You cannot retrieve more than 20 properties at a time". Para recuperar conjuntos grandes debés paginar.
• from es un offset, no un número de página. from=2 devuelve registros a partir de la posición 3, no "página 2".
• Los filtros numéricos esperan un entero. Un valor fuera del rango de un entero (por ejemplo, un número de 20 dígitos) o con decimales retorna un error de validación en vez de ignorarse en silencio.
• El campo took indica el tiempo en milisegundos que tardó la búsqueda en el servidor para esa página.

Respuesta

Un documento JSON con la lista de zonas en jerarquía donde el cliente tiene propiedades.

Los campos propios del desarrollo

Un desarrollo es una propiedad con campos extra, y son los que lo hacen útil:

Son los valores que declaró la inmobiliaria para el proyecto. No son el resultado de contar las unidades de developmentProperties: un desarrollo puede anunciar 500 viviendas y tener cargadas 12.

developmentStats — los números DERIVADOS de las unidades

Desde el 2026-10-27 cada desarrollo trae un bloque developmentStats con los indicadores que salen de contar sus unidades. No lo cargó nadie: se calcula en el backend a partir de las unidades que el desarrollo tiene vinculadas, y se recalcula cuando una de ellas cambia.

"developmentStats": {
  "units":  { "total": 4, "available": 4, "sold": 0, "rented": 0, "reserved": 0,
              "suspended": 0, "withOperation": 0, "availabilityRate": 100 },
  "sale":   { "units": 4, "commercialized": 0, "rate": 0 },
  "rent":   { "units": 0, "commercialized": 0, "rate": null },
  "otherOperation": { "units": 0 },
  "buildingArea": { "unit": "m2", "total": 936, "available": 936,
                    "unavailable": 0, "sold": 0, "rented": 0, "reserved": 0 },
  "prices": { "mixedCurrencies": false,
              "byCurrency": { "ARS": { "units": 4, "from": 2333333, "to": 2333333,
                                       "total": 9333332, "average": 2333333 } } },
  "typology": { "byAmbiences": { "2": 4 }, "byRooms": { "2": 4 },
                "byBuildingArea": { "234": 4 }, "byLandArea": { "250": 4 } }
}

developmentId — de qué desarrollo es una propiedad

Desde el 2026-10-26 toda propiedad trae developmentId: el Id del desarrollo al que pertenece, o 0 si no pertenece a ninguno.

Es el inverso de developmentProperties, y completa la relación en los dos sentidos: con developmentProperties vas del proyecto a sus unidades; con developmentId, de una unidad a su proyecto.

Campos adicionales

Cada desarrollo trae además los mismos campos extra que una propiedad —seoUrl, typeDesc, operationDesc, descriptionFormatted, publishedAt, floors, garages, branchSeoUrl, customerCountry, customerCountryDesc, videos, alternativePrices, reservations y tempOccupied— documentados en GET /properties.

Respuesta de ejemplo

{
"took":6,
"total":3,
"properties": [
        {
"zipCode":"1884",
"country":"Argentina",
"developmentProperties": [
198102
            ],
"landArea":133,
"county":"Almirante Brown",
"buildingArea":235,
"cityId":897,
"type":220,
"ambiences":2,
"zone":"Malvinas Argentinas, Almirante Brown, Buenos Aires, Argentina",
"price":1200000,
"airConditionerType":"Central",
"publication": [
                {
"mercadolibre":false,
"plan":"no-plan"
                },
                {
"cabaprop":false,
"plan":"no-plan"
                },
                {
"zonaprop":false,
"plan":"no-plan"
                },
                {
"navent":false,
"plan":"no-plan"
                }
            ],
"state":"Buenos Aires",
"branchId":1,
"images": [],
"development":true,
"descriptionFormatted":"Descripcion de un desarrollo unico del sistema.",
"bathrooms":2,
"suspended":false,
"labels": [
"laundry",
"playroom",
"suite"
            ],
"propertyOperation":"Venta",
"bedrooms":2,
"garages":1,
"yearsOld":12,
"reserved":false,
"lastUpdate":"2024-10-22T12:21:00.000-03:00",
"customerCountryDesc":"Argentina",
"code":"1-DESARROLLO-3",
"city":"Malvinas Argentinas",
"description":"Descripcion de un desarrollo unico del sistema.",
"alternativePrices": [],
"title":"titulo de desarrollo",
"networks": [
"4",
"5"
            ],
"customerCountry":1,
"countryId":1,
"seoUrl":"venta-de-desarrollo-inmobiliario-en-malvinas-argentinas-almirante-brown-buenos-aires-1-247058",
"rented":false,
"countyId":140,
"propertyType":"Desarrollo Inmobiliario",
"hightlight": {},
"currency":"ARS",
"timestamp":"2024-10-03T00:00:00.000-03:00",
"sold":false,
"address":"Calle 123 1537",
"stateId":2,
"garage":1,
"propertyHash":"1a9ad9df2c25980db55e6f74c5d62b94",
"mainImage":"https://s3.amazonaws.com/mapaprop-dev-image/photos/noimage.gif",
"garageType":"Espacio Guarda Coche",
"location": {
"lon":"-58.54596230000001",
"lat":"-34.5904958"
            },
"attributes": [
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"hasLaundry",
"group_subtype":"spaces",
"id":"laundry",
"label":"Lavadero",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"petsReady",
"group_subtype":"extras",
"id":"petsReady",
"label":"Apto mascotas",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"playroom",
"group_subtype":"spaces",
"id":"playroom",
"label":"Playroom",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"hasPrivatElevator",
"group_subtype":"ammenities",
"id":"private-elevator",
"label":"Elevador privado",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"suite",
"group_subtype":"spaces",
"id":"suite",
"label":"Dormitorio en suite",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                }
            ],
"operation":1
        }
    ]
}