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:


`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": {
  "argenprop": { "itemId": null, "remoteStatus": null },
  "zonaprop":  { "itemId": null, "remoteStatus": null }
}

Campo	Qué es
`itemId`	El id del aviso en ese portal
`remoteStatus`	Su estado del otro lado

`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