This service will return the list of zones where the customer has properties
| Resource information | |
|---|---|
| Authentication | Required (API Token, Bearer) |
| Scope | express-base |
| HTTP Method | GET |
| Response | JSON |
| Version | 1 |
Resource URL
https://mapaprop.app/api/action/express-v1/zones
Sample code
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}
Response
A JSON document with the list of zones in a hierarchy where the customer has properties.
| Object | Field | Type | Required | Description |
|---|---|---|---|---|
| Response | states | Array of State | yes | The list of State objects |
| State | description | string | yes | The description of the state |
| id | int | yes | The ID of the state | |
| count | int | yes | Number of the customer's published properties in that state | |
| counties | Array of County | no | The list of County objects (this is the second geographical division of the region. might not be an actual county) | |
| County | description | string | yes | The description of the county |
| id | int | yes | The ID of the county | |
| count | int | yes | Number of the customer's published properties in that county | |
| cities | Array of City | no | The list of City objects | |
| City | description | string | yes | The description of the city |
| id | int | yes | The ID of the city | |
| count | int | yes | Number of the customer's published properties in that city |
About count
It is the number of published properties the customer has in that zone, using the same criteria as the rest of the service. It lets you build a picker showing how many properties there are in each zone without one request per zone.
The levels add up: a state's count includes every one of its counties, and a county's includes every one of its cities.
A zone only appears in the response if the customer has at least one published property in it, so count is never 0.
Change of 29 September 2026. Until that date the cities array repeated one entry per property: a county with 100 properties across 20 cities returned 100 entries, with the same city several times. It now returns one entry per city, and the number of properties travels in count. If your integration was deduplicating on its own, you can stop; if it counted the repeated entries to estimate volume, use count.
Sample response
{
"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
}
]
}
]
}
]
}