Este servicio retorna el listado de zonas donde el cliente tiene propiedades.
| Información del recurso | |
|---|---|
| Autenticación | Requerida (Token de API, Bearer) |
| Scope | express-base |
| HTTP Method | GET |
| Response | JSON |
| Version | 1 |
URL del recurso
https://mapaprop.app/api/action/express-v1/zones
Código de ejemplo
GET /api/action/express-v1/zones HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}
Respuesta
Un documento JSON con el listado de zonas en jerarquía donde el cliente tiene propiedades.
| Objeto | Campo | Tipo | Requerido | Descripción |
|---|---|---|---|---|
| Response | states | Array of State | yes | La lista de objetos State |
| State | description | string | yes | La descripción de la provincia |
| id | int | yes | El ID de la provincia | |
| count | int | yes | Cantidad de propiedades publicadas del cliente en esa provincia | |
| counties | Array of County | no | La lista de objetos County (es la segunda división geográfica de la región; puede no ser un partido en sentido estricto) | |
| County | description | string | yes | La descripción del partido |
| id | int | yes | El ID del partido | |
| count | int | yes | Cantidad de propiedades publicadas del cliente en ese partido | |
| cities | Array of City | no | La lista de objetos City | |
| City | description | string | yes | La descripción de la ciudad |
| id | int | yes | El ID de la ciudad | |
| count | int | yes | Cantidad de propiedades publicadas del cliente en esa ciudad |
Sobre count
Es la cantidad de propiedades publicadas del cliente en esa zona, con el mismo criterio que usa el resto del servicio. Sirve para armar un selector que muestre cuántas propiedades hay en cada zona sin tener que hacer una consulta por zona.
Los niveles acumulan: el count de una provincia incluye el de todos sus partidos, y el de un
partido incluye el de todas sus ciudades.
Una zona aparece en la respuesta sólo si el cliente tiene al menos una propiedad publicada en
ella, así que count nunca es 0.
Cambio del 29 de septiembre de 2026. Hasta esa fecha el arreglo cities repetía una entrada
por cada propiedad: un partido con 100 propiedades en 20 ciudades devolvía 100 entradas, con la
misma ciudad varias veces. Ahora devuelve una entrada por ciudad, y la cantidad de
propiedades viaja en count. Si su integración deduplicaba por su cuenta, puede dejar de
hacerlo; si contaba las entradas repetidas para estimar volumen, use count.
Ejemplo de respuesta
{
"states": [
{
"description": "Capital Federal",
"id": 1,
"count": 98,
"counties": [
{
"description": "Belgrano R",
"id": 14,
"count": 6
},
{
"description": "Las Cañitas",
"id": 15,
"count": 3
},
{
"description": "Microcentro",
"id": 24,
"count": 7
},
{
"description": "Monserrat",
"id": 25,
"count": 1
},
{
"description": "Puerto Madero",
"id": 26,
"count": 2
},
{
"description": "Retiro",
"id": 27,
"count": 9
},
{
"description": "San Nicolás",
"id": 28,
"count": 2
},
{
"description": "Colegiales",
"id": 32,
"count": 6
},
{
"description": "Congreso",
"id": 33,
"count": 1
},
{
"description": "Nuñez",
"id": 43,
"count": 9
},
{
"description": "Palermo",
"id": 46,
"count": 4
},
{
"description": "Palermo Chico",
"id": 48,
"count": 1
},
{
"description": "Palermo Hollywood",
"id": 49,
"count": 2
},
{
"description": "Palermo Soho",
"id": 50,
"count": 7
},
{
"description": "San Cristobal",
"id": 58,
"count": 7
},
{
"description": "San Telmo",
"id": 59,
"count": 2
},
{
"description": "Villa Crespo",
"id": 62,
"count": 4
},
{
"description": "Almagro",
"id": 90,
"count": 2
},
{
"description": "Balvanera",
"id": 91,
"count": 9
},
{
"description": "Belgrano",
"id": 93,
"count": 7
},
{
"description": "Constitución",
"id": 99,
"count": 1
},
{
"description": "Recoleta",
"id": 116,
"count": 2
},
{
"description": "Barrio Norte",
"id": 654,
"count": 4
}
]
},
{
"description": "Córdoba",
"id": 6,
"count": 1,
"counties": [
{
"description": "Colón",
"id": 273,
"count": 1,
"cities": [
{
"description": "Colonia Tirolesa",
"id": 255,
"count": 1
}
]
}
]
},
{
"description": "Formosa",
"id": 9,
"count": 7,
"counties": [
{
"description": "Laishi",
"id": 496,
"count": 7,
"cities": [
{
"description": "Herradura",
"id": 2896,
"count": 7
}
]
}
]
},
{
"description": "La Rioja",
"id": 12,
"count": 1,
"counties": [
{
"description": "Chilecito",
"id": 561,
"count": 1,
"cities": [
{
"description": "Colonia Malligasta",
"id": 4011,
"count": 1
}
]
}
]
}
]
}