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
→Response fields description


Get user's addresses

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

Call:

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

Example:

curl -X GET https://api.mercadolibre.com/users/145834937/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

Field Sub-field Description
id Requested address ID.
user_id User ID
contact Name of the information owner (user).
phone User’s telephone number.
adress_line User's full address (street and number).
floor Building floor, if the address belongs to an apartment.
apartment Apartment identification (number or letter).
street_number Street number of the address mentioned in “address_line”.
street_name Street name of the address mentioned in “address_line”.
zip_code Zip code.
city City where the address is located.
id Unique city identifier (locations API core).
name Name of the city.
state State/province where the city is located.
id Unique city state/province identifier (locations API core).
name Name of the state/province.
copuntry Country where the address is located.
id Unique city country identifier (locations API core).
name Name of the country,
neighborhood Neighborhood associated to the address.
id Unique neighborhood identifier.
name Name of the neighborhood.
municipality Municipality associated to the address.
id Unique municipality identifier,
name Name of the municipality.
search_location Information about the address to be used in search lists.
state State/province where the city is located as per Classified.  The ID is associated to the classified locations API.
city City where the address is located, as per Classified. The ID is associated to the classified locations API.
neighbourhood Neighborhood where the address is located as per Classified. The ID is associated to the classified locations API.
types It 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.
latitude Google Maps latitude.
longitude Google Maps longitude.
status Address status. Possible values: active or inactive.
date_created Date and time when it was created.
normalized It indicates if the stored data is correct. If not, it will be false. Possible values: true, false.
open_hours Business hours, if the address belongs to a store.
on_holidays Special business hours on holidays. Sub-attribute hours included.

Next topic: Add and manage user’s bookmarks.