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:
portals | lo que diría el sistema hoy |
verdictAtCreation | lo 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" }
}
| Campo | Qué es |
|---|---|
itemId | El código con el que nosotros nombramos el aviso en ese portal |
portalItemId | El id que el portal le dio al aviso — ver abajo |
remoteStatus | Su 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"
}
}
}
| Campo | Qué es |
|---|---|
url | Dónde se ve el aviso publicado |
remote | Todo lo que dijo el portal la última vez que le preguntamos — el detalle completo acá |
remote.checkedAt | De 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:
| Campo | De quién es | De dónde sale | ¿Cuesta? |
|---|---|---|---|
itemId | nuestro — el código con el que publicamos | lo armamos nosotros | gratis |
portalItemId | del portal | lo contestó al publicar | gratis |
remote.portalItemId | del portal | lo contestó al consultar el estado | 1 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 }
]
| Campo | Qué es |
|---|---|
slot | image o blueprint |
source | La URL que nos mandaste |
url | Dónde quedó alojada. Sólo si ok |
error | Por 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ódigo | Cuándo |
|---|---|
401 | Token ausente, vencido o inválido |
404 | Ese 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
- POST /properties — el alta
- DELETE /properties/{paId} — borrar