BETA

GET /properties

Dos formas: una propiedad por su paId, o el listado de las tuyas.

Una propiedad

GET https://property-api.mapaprop.com/property-v1/properties/{paId}

El listado

GET https://property-api.mapaprop.com/property-v1/properties
{ "total": 12, "items": [ { "…" } ] }

El listado es de UN clientRef, no de todo tu inventario. Devuelve las propiedades de la cliente que mandás en x-client-ref. Si querés el inventario de otra, la pedís con su clientRef. Ver clientRef.

Autenticación

Authorization: Bearer <tu token>.

curl https://property-api.mapaprop.com/property-v1/properties/01M3PTZ8YBMM5DSNW03WP8VD9E \
  -H "Authorization: Bearer $TOKEN"

La respuesta

La respuesta trae el clientRef, el mismo que mandaste en el sobre. Te lo devolvemos en los seis caminos (verify, alta, consulta, listado, edición y borrado) para que puedas cruzarlo con tu base sin tener que recordar con qué clientRef preguntaste.

Lo mismo que te devolvió el alta —object, portals, summary— más el detalle de las imágenes.

Los portales se recalculan en cada consulta. No es una foto del día que diste de alta: si mejoramos el mapeo de un portal, lo ves acá sin volver a postear nada.

verdictAtCreation — el veredicto del día del alta

Además de portals —que se recalcula— el GET trae el veredicto tal como fue el día que diste de alta, con su fecha:

"verdictAtCreation": {
  "at": "2026-09-29T21:52:43.549Z",
  "argenprop": { "status": "fields_complete", "blockers": [] },
  "zonaprop":  { "status": "fields_complete", "blockers": [] }
}

Para decidir si publicar, mirá portals, no esto. Los dos conviven a propósito y dicen cosas distintas:

portalslo que diría el sistema hoy
verdictAtCreationlo que dijo el día del alta, con su fecha

verdictAtCreation es registro histórico: sirve para explicar por qué un alta de hace un mes pasó o no pasó, con el mapeo que existía entonces.

published — qué hay publicado en cada portal

Lo que el publish escribió del otro lado. Mientras no publiques, viene en null:

"published": {
  "cabaprop":  { "itemId": null, "remoteStatus": null },
  "argenprop": { "itemId": "01M41AQNXYG4W4SEEEEPHEDNX4", "portalItemId": 20685478, "remoteStatus": "published" },
  "zonaprop":  { "itemId": "01M41AQNXYG4W4SEEEEPHEDNX4", "remoteStatus": "published" }
}
CampoQué es
itemIdEl código con el que nosotros nombramos el aviso en ese portal
portalItemIdEl id que el portal le dio al aviso — ver abajo
remoteStatusSu estado: published, unpublished o error

portalItemId — el id del portal, sin gastar cuota

Algunos portales devuelven el id del aviso en la misma respuesta que lo publica. Cuando lo hacen, lo guardamos y te lo damos acá: es el número con el que el aviso existe en el panel del portal, y el que su soporte reconoce si tu cliente les escribe.

Portal¿Lo trae?
Argenprop✅lo devuelve al publicar
Zonaprop—su publicación va identificada por el código que mandamos nosotros: no devuelve un id propio

No hace falta consultar el estado para tenerlo. Aparece en cuanto publicás, y leerlo acá es gratis. Si tu portal no está en la tabla, el campo se omite — no viene en null.

⚠️ Puede cambiar durante la vida de la propiedad. En Argenprop, dar de baja un aviso libera su código, así que volver a publicar crea un aviso nuevo, con otro portalItemId. Si guardás el número de tu lado, releelo después de cada publicación.

Y si consultaste el estado, también url y remote

Cuando usás GET …/publication/{portal}, lo que el portal contestó queda guardado acá. Así lo volvés a leer sin gastar otra llamada de cuota:

"published": {
  "zonaprop": {
    "itemId": "01M41AQNXYG4W4SEEEEPHEDNX4",
    "remoteStatus": "published",
    "url": "https://www.zonaprop.com.ar/propiedades/clasificado/-60321762.html",
    "remote": {
      "portalItemId": 60321762,
      "publicationState": "ONLINE",
      "visits": 37,
      "checkedAt": "2026-10-03T18:42:57.716Z"
    }
  }
}
CampoQué es
urlDónde se ve el aviso publicado
remoteTodo lo que dijo el portal la última vez que le preguntamos — el detalle completo acá
remote.checkedAtDe cuándo es este dato. Si te alcanza, no hace falta volver a consultar

url y remote no aparecen hasta que consultes el estado al menos una vez. No vienen en null a propósito: un null diría "no hay estado en el portal", y lo cierto es "todavía no preguntamos".

Son TRES campos y nombran al mismo aviso de tres maneras. Vale tenerlos claros:

CampoDe quién esDe dónde sale¿Cuesta?
itemIdnuestro — el código con el que publicamoslo armamos nosotrosgratis
portalItemIddel portallo contestó al publicargratis
remote.portalItemIddel portallo contestó al consultar el estado1 llamada de cuota

Los dos últimos nombran lo mismo y deberían coincidir. Si difieren, el de remote es más viejo: dice lo que el portal reportaba en su checkedAt.

⚠️ La url sigue necesitando el estado — pero por otro motivo: el id solo no alcanza, hace falta además saber armar la dirección pública de ese portal. Hoy la armamos para Zonaprop; para Argenprop todavía no, así que su url queda en null antes que darte un link roto.

mapaprop — el alta en tu cuenta

Sólo si sos cliente de Mapaprop y generaste tu token desde la app. La propiedad se da de alta sola en tu cuenta cuando termina la ingesta de las imágenes, y este bloque dice cómo salió:

{
  "mapaprop": {
    "state": "synced",
    "propertyId": 2619527,
    "branchId": 1,
    "message": "La propiedad existe en tu cuenta de Mapaprop con el id 2619527 (sucursal 1)…"
  }
}

El propertyId es el id de Mapaprop, distinto del paId de esta API: es con el que la encontrás en la app. Los estados (pending, synced, rejected, blocked, exhausted), qué significa cada uno y cuándo reintentar están en Reintentar el alta; el panorama completo, en Mapaprop.

Esta es la forma de enterarte si algo falló. El alta corre sola y en diferido, así que el estado se consulta acá — no te avisamos por otro canal.

synced significa que la propiedad existe en tu cuenta, no que esté publicada.

images y assets — el estado de tus imágenes

images te da el resumen y assets el detalle, una entrada por imagen:

"images": { "status": "partial", "total": 4, "processed": 3 },
"assets": [
  { "n": 1, "slot": "image", "source": "https://tu-cdn.com/frente.jpg",
    "url": "https://…/image-1.jpg", "ok": true },
  { "n": 2, "slot": "image", "source": "https://tu-cdn.com/living.jpg",
    "error": "el host del origen no existe (DNS no resuelve) [ENOTFOUND]", "ok": false }
]
CampoQué es
slotimage o blueprint
sourceLa URL que nos mandaste
urlDónde quedó alojada. Sólo si ok
errorPor qué no se pudo bajar. Sólo si no ok

Los estados de images.status y qué hacer con cada uno están en POST /properties.

Errores

CódigoCuándo
401Token ausente, vencido o inválido
404Ese paId no existe

El GET nunca devuelve 409: consultar se puede siempre, incluso mientras las imágenes están descargándose. De hecho es así como se sigue el avance.

Relacionados