PRODUCTION

This service will return the list of development properties

Resource information
Authentication	Required
HTTP Method	GET
Response	JSON
Version	1

Resource URL

https://mapaprop.app/api/action/express-v1/developments

Sample code

GET /api/action/express-v1/developments?customerId=1&dateFrom=20-02-2019&dateTo=28-02-2019 HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer ya29.1.AADtN_UxybTdjLw9jX6lg_branSjjsldiwjtek4q2WvfETzSrz7Q6loEYoJEWd1x4qvlpGw

Parameters

Key	Type	Required	Description
customerId	int	no	The customer ID to scope the search. Defaults to the authenticated client's customer ID.
term	string	no	A term that will try to match at least 3 characters in the zone, address or title of the property. Full text search capabilities.
type	int	no	Always overridden to 23 (Desarrollo Inmobiliario) by the API. Any user-provided value is ignored. Constants
operation	int	no	An operation of the property. Constants
from	int	no	The start record number. Default is 0.
size	int	no	The amount of records to bring in each query. Default is 7. Maximum is 20 (validation error: "You cannot retrieve more than 20 properties at a time").
branchId	int	no	The ID of the branch where the properties are located.
stateId	int	no	The state ID of the property
countyId	int	no	The county ID of the property
cityId	int	no	The city ID of the property
tempOccupancy	int	no	The number of people who can live in a property
dateFrom	string	no	The date you want to arrive (format is "dd-MM-yyyy")
dateTo	string	no	The date you want to leave (format is "dd-MM-yyyy")

Pagination

This endpoint uses offset-based pagination via the from and size query parameters.

Parameter	Meaning	Default	Maximum
`from`	Zero-based offset of the first record to return	`0`	—
`size`	Number of records returned per request	`7`	`20`

The response always includes a total field with the total number of records matching your filters (not just the ones returned in the current page). Use it to know when to stop paginating.

How to paginate

To retrieve page N (1-indexed) with a fixed page size:

from = (N - 1) * size

Keep requesting the next page while from + size < total.

Example: paginate through 25 developments, 20 per page

Assume a search returns "total": 25. To get every result you need 2 requests:

Page 1 — records 1 to 20:

GET /api/action/express-v1/developments?from=0&size=20

Response: { "took": 8, "total": 25, "properties": [ ...20 items... ] }

Page 2 — records 21 to 25:

GET /api/action/express-v1/developments?from=20&size=20

Response: { "took": 6, "total": 25, "properties": [ ...5 items... ] }

At this point from + size = 40 >= total = 25, so there are no more pages.

Notes

Keep filters consistent across pages. Changing any filter between requests (e.g. operation, stateId, dateFrom) resets the result set and your offset will point to a different collection.
size cannot exceed 20. Requesting size=21 or more returns a validation error: "You cannot retrieve more than 20 properties at a time". To retrieve large result sets you must paginate.
from is an offset, not a page number. from=2 returns records starting at position 3, not "page 2".
The took field is the time in milliseconds the search took on the server side for that page only.

Response

A JSON document with the list of zones in a hierarchy where the customer has properties.

Object	Field	Type	Required	Description
Response	took	int	yes	How long the search took in milliseconds
	total	int	yes	How many total records are in the context of this search. You can paginate thru them
	properties	Array of Property	yes	The list of Property objects
Property	propertyHash	string	yes	A unique ID for the property
	timestamp	string	yes	ISO8601 timestamp of when the property was created
	lastUpdate	string	yes	ISO8601 timestamp of when the property was last updated
	code	string	yes	A unique code of the property entered by the customer
	branchId	int	yes	The ID of the branch that this property is related to. GET /api/action/express-v1/branches.
	type	int	yes	The Id of property type. GET /api/action/express-v1/types
	operation	int	yes	The Id of property operation. Constants
	propertyType	string	yes	The translated description of the property type. GET /api/action/express-v1/types
	propertyOperation	string	yes	The translated description of the property operations. Constants
	status	string	yes	The translated description of the building status. Constants
	mainImage	string	no	The Id of property type. GET /api/action/express-v1/types
	currency	string	yes	The currency symbol of the price of the property. Constants
	price	int	yes	The price of the property
	expensesCurrencies	string	no	The currency symbol of the monthly / yearly expenses of the property. Constants
	expensesPrice	int	no	The price of the monthly / yearly expenses of the property
	taxCurrency	string	no	The currency symbol of the monthly / yearly taxes of the property. Constants
	taxPrice	int	no	The price of the monthly / yearly taxes of the property
	title	string	yes	A title entered by the customer
	address	string	yes	The street address and number of the property
	zipCode	string	yes	The postal code of property location
	zone	string	yes	A friendly description combining from city (if available) to state
	countryId	int	yes	The ID of the property country location
	stateId	int	yes	The ID of the property state location. GET /api/action/express-v1/zones
	countyId	int	yes	The ID of the property county location. GET /api/action/express-v1/zones
	cityId	int	no	The ID of the property city location. GET /api/action/express-v1/zones
	countryId	int	yes	The ID of the property country location. GET /api/action/express-v1/zones
	country	string	yes	The name of the country
	state	string	yes	The name of the state
	county	string	yes	The name of the county or 2nd division location
	city	string	no	The name of the city / neighborhood or 3rd division
	suspended	boolean	yes	The publication has been suspended
	reserved	boolean	yes	The property has been reserved
	rented	boolean	yes	The property has been rented
	sold	boolean	yes	The property has been sold
	description	string	yes	The long description of the property
	conditions	string	no	The long conditions statement of the property. Usually related to payments
	bedrooms	int	no	Number of bedrooms of the property
	ambiences	int	no	The number of ambiences / spaces for the property
	bathrooms	int	no	Number of bathrooms of the property
	dependencies	int	no	Number of dependency rooms (extra rooms)
	occupancy	int	no	Number of occupants (generally if this is a temp rental)
	toilettes	int	no	Number of toilettes (half bathrooms) in the property
	buildingArea	int	no	Square meters of the built area
	landArea	int	no	Square meters of the land of the property
	yearsOld	int	no	How old the property is
	ubication	string	no	The property cardinal ubication in the building
	totalFloors	int	no	The total floors in the building
	apartmentsPerFloor	int	no	The amount of apartments per floor
	airConditionerType	string	no	Type of air conditioner.
	waterHeaterType	string	no	Type of water heater.
	heatingType	string	no	Type of heating appliances.
	balconyType	string	no	Type of balcony.
	garage	int	no	The total garages of the property
	garageType	string	no	Type of garage.
	images	Array of Image	no	Array of Image object
	location	Location	yes	Location object
Location	lon	string	yes	Longitude location of the property
	lat	string	yes	Latitude location of the property
Image	image	string	yes	URL for image
	thumbnail	string	yes	URL for the thumbail
	orientation	int	yes	Orientation of the image. 1 = PORTRAIT, 2 = LANDSCAPE
	type	int	yes	Type of image. 1 = PHOTO, 2 = BLUEPRINT
	contentType	string	yes	The image content type
	timestamp	string	yes	The ISO8601 timestamp of when the image was uploaded
Labels	labels	Array of labels	no	The labels of property. Constants
attributes	attributes	Array of json attributes	no	All property attributes
descriptionFormatted	description	string	no	Description with new formatting that accepts line breaks

Sample response

{
"took":6,
"total":3,
"properties": [
        {
"zipCode":"1884",
"country":"Argentina",
"developmentProperties": [
198102
            ],
"landArea":133,
"county":"Almirante Brown",
"buildingArea":235,
"cityId":897,
"type":220,
"ambiences":2,
"zone":"Malvinas Argentinas, Almirante Brown, Buenos Aires, Argentina",
"price":1200000,
"airConditionerType":"Central",
"publication": [
                {
"mercadolibre":false,
"plan":"no-plan"
                },
                {
"cabaprop":false,
"plan":"no-plan"
                },
                {
"zonaprop":false,
"plan":"no-plan"
                },
                {
"navent":false,
"plan":"no-plan"
                }
            ],
"state":"Buenos Aires",
"branchId":1,
"images": [],
"development":true,
"descriptionFormatted":"Descripcion de un desarrollo unico del sistema.",
"bathrooms":2,
"suspended":false,
"labels": [
"laundry",
"playroom",
"suite"
            ],
"propertyOperation":"Venta",
"bedrooms":2,
"garages":1,
"yearsOld":12,
"reserved":false,
"lastUpdate":"2024-10-22T12:21:00.000-03:00",
"customerCountryDesc":"Argentina",
"code":"1-DESARROLLO-3",
"city":"Malvinas Argentinas",
"description":"Descripcion de un desarrollo unico del sistema.",
"alternativePrices": [],
"title":"titulo de desarrollo",
"networks": [
"4",
"5"
            ],
"customerCountry":1,
"countryId":1,
"seoUrl":"venta-de-desarrollo-inmobiliario-en-malvinas-argentinas-almirante-brown-buenos-aires-1-247058",
"rented":false,
"countyId":140,
"propertyType":"Desarrollo Inmobiliario",
"hightlight": {},
"currency":"ARS",
"timestamp":"2024-10-03T00:00:00.000-03:00",
"sold":false,
"address":"Calle 123 1537",
"stateId":2,
"garage":1,
"propertyHash":"1a9ad9df2c25980db55e6f74c5d62b94",
"mainImage":"https://s3.amazonaws.com/mapaprop-dev-image/photos/noimage.gif",
"garageType":"Espacio Guarda Coche",
"location": {
"lon":"-58.54596230000001",
"lat":"-34.5904958"
            },
"attributes": [
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"hasLaundry",
"group_subtype":"spaces",
"id":"laundry",
"label":"Lavadero",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"petsReady",
"group_subtype":"extras",
"id":"petsReady",
"label":"Apto mascotas",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"playroom",
"group_subtype":"spaces",
"id":"playroom",
"label":"Playroom",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"hasPrivatElevator",
"group_subtype":"ammenities",
"id":"private-elevator",
"label":"Elevador privado",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"suite",
"group_subtype":"spaces",
"id":"suite",
"label":"Dormitorio en suite",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                }
            ],
"operation":1
        },
        {
"zipCode":"1884",
"country":"Argentina",
"developmentProperties": [
30378,
188242,
193054,
196831,
206881,
247032
            ],
"landArea":233,
"county":"Botanico",
"buildingArea":123,
"type":220,
"ambiences":2,
"zone":"Botanico, Capital Federal, Argentina",
"price":1100005,
"publication": [
                {
"mercadolibre":false,
"plan":"no-plan"
                },
                {
"cabaprop":false,
"plan":"no-plan"
                },
                {
"zonaprop":false,
"plan":"no-plan"
                },
                {
"navent":false,
"plan":"no-plan"
                }
            ],
"state":"Capital Federal",
"branchId":1,
"images": [
                {
"image":"https://s3.amazonaws.com/mapaprop-dev-image/photos/1/247059/2719080.jpg",
"thumbnail":"https://s3.amazonaws.com/mapaprop-dev-image/photos/1/247059/2719080t.jpg",
"orientation":2,
"imageId":2719080,
"main":false,
"type":2,
"contentType":"image/png",
"order":0,
"timestamp":"2024-10-16T17:54:55Z"
                }
            ],
"development":true,
"descriptionFormatted":"Descipcion desarrollo",
"bathrooms":2,
"suspended":false,
"labels": [],
"propertyOperation":"Venta",
"bedrooms":2,
"garages":1,
"yearsOld":2,
"reserved":false,
"lastUpdate":"2024-10-22T12:20:40.000-03:00",
"customerCountryDesc":"Argentina",
"code":"1-DESARROLLO-5",
"description":"Descipcion desarrollo",
"alternativePrices": [],
"title":"desarrollo 5 desarrollo",
"networks": [
"4",
"5"
            ],
"customerCountry":1,
"countryId":1,
"seoUrl":"venta-de-desarrollo-inmobiliario-en-botanico-capital-federal-1-247059",
"rented":false,
"countyId":47,
"propertyType":"Desarrollo Inmobiliario",
"hightlight": {},
"currency":"ARS",
"timestamp":"2024-10-10T00:00:00.000-03:00",
"sold":false,
"address":"Calle 123 1537",
"stateId":1,
"garage":1,
"propertyHash":"b0de5a06d5ee23bb765802aab5fca859",
"mainImage":"https://s3.amazonaws.com/mapaprop-dev-image/photos/noimage.gif",
"garageType":"Garage Cubierto",
"location": {
"lon":"-58.54596230000001",
"lat":"-34.5904958"
            },
"attributes": [],
"operation":1
        },
        {
"zipCode":"1884",
"country":"Argentina",
"developmentProperties": [
218437,
247044
            ],
"landArea":133,
"county":"Almirante Brown",
"buildingArea":235,
"cityId":897,
"type":220,
"ambiences":2,
"zone":"Malvinas Argentinas, Almirante Brown, Buenos Aires, Argentina",
"price":1200000,
"publication": [
                {
"mercadolibre":false,
"plan":"no-plan"
                },
                {
"cabaprop":false,
"plan":"no-plan"
                },
                {
"zonaprop":false,
"plan":"no-plan"
                },
                {
"navent":false,
"plan":"no-plan"
                }
            ],
"state":"Buenos Aires",
"branchId":1,
"images": [],
"development":true,
"descriptionFormatted":"Descripcion de un desarrollo unico del sistema. ffff eee ffff HHHH",
"bathrooms":2,
"suspended":false,
"labels": [
"mortgage-ready",
"wifi",
"barbecue-area"
            ],
"propertyOperation":"Venta",
"bedrooms":2,
"garages":1,
"yearsOld":12,
"reserved":false,
"lastUpdate":"2024-10-22T12:20:32.000-03:00",
"customerCountryDesc":"Argentina",
"code":"1-DESARROLLO-1",
"city":"Malvinas Argentinas",
"description":"Descripcion de un desarrollo unico del sistema. ffff eee ffff HHHH",
"alternativePrices": [],
"title":"titulo de desarrollo sss AAA",
"networks": [
"4",
"5"
            ],
"customerCountry":1,
"countryId":1,
"seoUrl":"venta-de-desarrollo-inmobiliario-en-malvinas-argentinas-almirante-brown-buenos-aires-1-247055",
"rented":false,
"countyId":140,
"propertyType":"Desarrollo Inmobiliario",
"hightlight": {},
"currency":"ARS",
"timestamp":"2024-10-03T00:00:00.000-03:00",
"sold":false,
"address":"Calle 123 1537",
"stateId":2,
"garage":1,
"propertyHash":"58a83e9129d43905e39d8cf2a3e355a3",
"mainImage":"https://s3.amazonaws.com/mapaprop-dev-image/photos/noimage.gif",
"garageType":"Espacio Guarda Coche",
"location": {
"lon":"-58.54596230000001",
"lat":"-34.5904958"
            },
"attributes": [
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"barbecueArea",
"group_subtype":"spaces",
"id":"barbecue-area",
"label":"Quincho",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"internet",
"group_subtype":"services",
"id":"internet",
"label":"Internet",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"mortgageReady",
"group_subtype":"extras",
"id":"mortgage-ready",
"label":"Apto crédito",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"hasSecurity",
"group_subtype":"services",
"id":"security",
"label":"Seguridad",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                },
                {
"group_sub":"label",
"country":"ar",
"key_legacy":"wifi",
"group_subtype":"services",
"id":"wifi",
"label":"WIFI",
"locale":"es_AR",
"type":"bool",
"group":"propertyAttribute",
"status":true
                }
            ],
"operation":1
        }
    ]
}