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

Field Sub-field Description
id Requested address ID
user_id User ID
contact Name of the information owner (user)
phone User’s telephone number
address_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
country 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.

comment Comments on the address information.
geolocation_type Approximate range of the address in question, based on Google Maps’ latitude and longitude parameters.
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.

Please rate this