User’s addresses

The purpose of the following document is to introduce the Address API, specifying the fields listed in the response to your query, along with the potential responses to those fields.

Contents:

Get user’s addresses

To make a call to this API, you will need an access token.

Example:

curl -X GET https://api.mercadolibre.com/users/{User_id}/addresses?access_token=$ACCESS_TOKEN

Response:

{
	"id": 145834937,
	"user_id": "160252486",
	"contact": null,
	"phone": null,
	"address_line": "Guatemala 5100",
	"floor": null,
	"apartment": null,
	"street_number": "5100",
	"street_name": "Guatemala",
	"zip_code": "1000",
	"city": -{
    	"id": "TUxBQlBBTDI1MTVa",
    	"name": "Palermo",
	},
	"state": -{
    	"id": "AR-C",
    	"name": "Capital Federal",
    	
	},
	"country": -{
    	"id": "AR",
    	"name": "Argentina",
	},
	"neighborhood": -{
    	"id": null,
    	"name": null,
	},
	"municipality": -{
    	"id": null,
    	"name": null,
	},
	"search_location": -{
    	"state": -{
        	"id": "TUxBUENBUGw3M2E1",
        	"name": "Capital Federal",
    	},
    	"city": -{
        	"id": "TUxBQ0NBUGZlZG1sYQ",
        	"name": "Capital Federal",
    	},
    	"neighborhood": -{
        	"id": "TUxBQlBBTDI1MTVa",
        	"name": "Palermo",
    	},
	},
	"types": -[
        "default_selling_address",
    	"shipping",
	],
	"comment": "",
	"geolocation_type": "RANGE_INTERPOLATED",
	"latitude": -34.5834729,
	"longitude": -58.4281022,
	"status": "active",
	"date_created": "2014-06-05T12:26:54.000-04:00",
	"normalized": true,
	"open_hours": -{
    	"on_holidays": -{
        	"hours": [
        	],
        	"status": "closed",
    	},
	},
}

Response fields description

FieldSub-fieldDescription
idRequested address ID
user_idUser ID
contactName of the information owner (user)
phoneUser’s telephone number
address_lineUser’s full address (street and number)
floorBuilding floor, if the address belongs to an apartment
apartmentApartment identification (number or letter)
street_numberStreet number of the address mentioned in “address_line”
street_nameStreet name of the address mentioned in “address_line”
zip_codeZip code
cityCity where the address is located
idUnique city identifier (locations API core)
nameName of the city
stateState/province where the city is located.
idUnique city state/province identifier (locations API core)
nameName of the state/province
countryCountry where the address is located
idUnique city country identifier (locations API core)
nameName of the country
neighborhoodNeighborhood associated to the address
idUnique neighborhood identifier.
nameName of the neighborhood
municipalityMunicipality associated to the address
idUnique municipality identifier
nameName of the municipality
search_locationInformation about the address to be used in search lists.
stateState/province where the city is located as per Classified.  The ID is associated to the classified locations API.
cityCity where the address is located, as per Classified. The ID is associated to the classified locations API.
neighbourhoodNeighborhood where the address is located as per Classified. The ID is associated to the classified locations API.
typesIt specifies the address type: Possible values:

● default_selling_address: selling address

● default_buying_address: buying address

● shipping: address from which shipments will be made

● billing: MercadoLibre billing address.

Types may include none, one, or several of the above attributes.

commentComments on the address information.
geolocation_typeApproximate range of the address in question, based on Google Maps’ latitude and longitude parameters.
latitudeGoogle Maps latitude.
longitudeGoogle Maps longitude.
statusAddress status. Possible values: active or inactive.
date_createdDate and time when it was created.
normalizedIt indicates if the stored data is correct. If not, it will be false. Possible values: true, false.
open_hoursBusiness hours, if the address belongs to a store.
on_holidaysSpecial business hours on holidays. Sub-attribute hours included.

Next topic: Add and manage user’s bookmarks.

Please rate this