| /classified_locations/countries * |
Returns countries information. |
GET
Go back
X
Get information about countries.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/countries
Response:
[
{
"id": "AR",
"name": "Argentina",
"locale": "es_AR",
"currency_id": "ARS"
},
{
"id": "BR",
"name": "Brasil",
"locale": "pt_BR",
"currency_id": "BRL"
},
{
"id": "CO",
"name": "Colombia",
"locale": "es_CO",
"currency_id": "COP"
},
{
"id": "CR",
"name": "Costa Rica",
"locale": "es_CR",
"currency_id": "CRC"
},
{
"id": "CL",
"name": "Chile",
"locale": "es_CL",
"currency_id": "CLP"
},
{
"id": "EC",
"name": "Ecuador",
"locale": "es_EC",
"currency_id": "USD"
},
{
"id": "MX",
"name": "Mexico",
"locale": "es_MX",
"currency_id": "MXN"
},
{
"id": "PA",
"name": "Panamá",
"locale": "es_PA",
"currency_id": "USD"
},
{
"id": "PE",
"name": "Peru",
"locale": "es_PE",
"currency_id": "PEN"
},
{
"id": "DO",
"name": "República Dominicana",
"locale": "es_DO",
"currency_id": "DOP"
},
{
"id": "UY",
"name": "Uruguay",
"locale": "es_UY",
"currency_id": "UYU"
},
{
"id": "VE",
"name": "Venezuela",
"locale": "es_VE",
"currency_id": "VEF"
},
{
"id": "GT",
"name": "Guatemala",
"locale": "es_GT",
"currency_id": "GTQ"
},
{
"id": "BO",
"name": "Bolivia",
"locale": "es_BO",
"currency_id": "BOB"
},
{
"id": "HN",
"name": "Honduras",
"locale": "es_HN",
"currency_id": "HNL"
},
{
"id": "NI",
"name": "Nicaragua",
"locale": "es_NI",
"currency_id": "NIO"
},
{
"id": "SV",
"name": "El Salvador",
"locale": "es_SV",
"currency_id": "USD"
},
{
"id": "PR",
"name": "Puerto Rico",
"locale": "es_PR",
"currency_id": "USD"
},
{
"id": "PY",
"name": "Paraguay",
"locale": "es_PY",
"currency_id": "PYG"
},
{
"id": "CU",
"name": "Cuba",
"locale": "es_CU",
"currency_id": "CUC"
}
]
Learn more.
|
| /classified_locations/countries/$COUNTRY_ID * |
Returns country information by country_id. |
GET
Go back
X
Get country detail
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/countries/UY
Response
{
"id": "UY",
"name": "Uruguay",
"locale": "es_UY",
"currency_id": "UYU",
"decimal_separator": ",",
"thousands_separator": ".",
"time_zone": "GMT-03:00",
"geo_information": null,
"states": [
{
"id": "UY-AR",
"name": "Artigas"
},
{
"id": "UY-CA",
"name": "Canelones"
},
{
"id": "UY-CL",
"name": "Cerro Largo"
},
{
"id": "UY-CO",
"name": "Colonia"
},
{
"id": "UY-DU",
"name": "Durazno"
},
{
"id": "UY-FS",
"name": "Flores"
},
{
"id": "UY-FD",
"name": "Florida"
},
{
"id": "UY-LA",
"name": "Lavalleja"
},
{
"id": "UY-MA",
"name": "Maldonado"
},
{
"id": "UY-MO",
"name": "Montevideo"
},
{
"id": "UY-PA",
"name": "Paysandú"
},
{
"id": "UY-RV",
"name": "Rivera"
},
{
"id": "UY-RO",
"name": "Rocha"
},
{
"id": "UY-RN",
"name": "Río Negro"
},
{
"id": "UY-SA",
"name": "Salto"
},
{
"id": "UY-SJ",
"name": "San José"
},
{
"id": "UY-SO",
"name": "Soriano"
},
{
"id": "UY-TA",
"name": "Tacuarembó"
},
{
"id": "UY-TT",
"name": "Treinta y Tres"
}
]
}
Learn more.
|
| /classified_locations/states/$STATE_ID * |
Returns state information. |
GET
Go back
X
Get state information.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/states/UY-RO
Response
{
"id": "UY-RO",
"name": "Rocha",
"country": {
"id": "UY",
"name": "Uruguay"
},
"geo_information": null,
"cities": [
{
"id": "TUxVQ0FHVWNmYTJk",
"name": "Aguas Dulces"
},
{
"id": "TUxVQ0JBTDE5ZmE",
"name": "Balneario La Esmeralda"
},
{
"id": "TUxVQ0JBUjM4MTA1",
"name": "Barra de Valizas"
},
{
"id": "TUxVQ0JBUjE4NWNj",
"name": "Barra del Chuy"
},
{
"id": "TUxVQ0NBQjY1MmQ1",
"name": "Cabo Polonio"
},
{
"id": "TUxVQ0NBUzQxYzlh",
"name": "Castillos"
},
{
"id": "TUxVQ0NIVThjNTFm",
"name": "Chuy"
},
{
"id": "TUxVQ0NPUzQzZDk0",
"name": "Costa Azul"
},
{
"id": "TUxVQ0VMUDM0OTI",
"name": "El Palmar"
},
{
"id": "TUxVQ0xBWmFlYzJh",
"name": "La Coronilla"
},
{
"id": "TUxVQ0xBWmYzMmU0",
"name": "La Palma"
},
{
"id": "TUxVQ0xBWmQ4YTc1",
"name": "La Paloma"
},
{
"id": "TUxVQ0xBWjQyNGEy",
"name": "La Pedrera"
},
{
"id": "TUxVQ0xBR2JkZGMy",
"name": "Laguna de Rocha"
},
{
"id": "TUxVQ0xBUzcyNDI",
"name": "Las Garzas"
},
{
"id": "TUxVQ0xBU2YyZDU1",
"name": "Lascano"
},
{
"id": "TUxVQ09UUjQxODQ",
"name": "Otras"
},
{
"id": "TUxVQ1BVTjE5ZTIw",
"name": "Punta del Diablo"
},
{
"id": "TUxVQ1JPQzFjOWE5",
"name": "Rocha"
},
{
"id": "TUxVQ1NBTmVhNWRk",
"name": "Santa Teresa"
},
{
"id": "TUxVQ1ZFTDhlZWM3",
"name": "Velázquez"
}
]
}
Learn more.
|
| /classified_locations/cities/$CITY_ID * |
Returns city information. |
GET
Go back
X
Get city information.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/cities/TUxVQ0NBQjY1MmQ1
Response
{
"id": "TUxVQ0NBQjY1MmQ1",
"name": "Cabo Polonio",
"state": {
"id": "UY-RO",
"name": "Rocha"
},
"country": {
"id": "UY",
"name": "Uruguay"
},
"geo_information": null
}
Learn more.
|
| /currencies |
Returns information about all available currencies in Mercado Libre. |
GET
Go back
X
Get currencies information.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/currencies/
Response
[
{
"id": "ARS",
"description": "Peso argentino",
"symbol": "$",
"decimal_places": 2
},
{
"id": "BRL",
"description": "Real",
"symbol": "R$",
"decimal_places": 2
},
{
"id": "CLF",
"description": "Unidad de Fomento",
"symbol": "UF",
"decimal_places": 2
},
{
"id": "CLP",
"description": "Peso Chileno",
"symbol": "$",
"decimal_places": 0
},
{
"id": "COP",
"description": "Peso colombiano",
"symbol": "$",
"decimal_places": 0
},
{
"id": "CRC",
"description": "Colones",
"symbol": "¢",
"decimal_places": 2
},
{
"id": "DOP",
"description": "Peso Dominicano",
"symbol": "$",
"decimal_places": 2
},
{
"id": "EUR",
"description": "Euro",
"symbol": "€",
"decimal_places": 2
},
{
"id": "MXN",
"description": "Peso Mexicano",
"symbol": "$",
"decimal_places": 2
},
{
"id": "PAB",
"description": "Balboa",
"symbol": "B/.",
"decimal_places": 2
},
{
"id": "PEN",
"description": "Soles",
"symbol": "S/.",
"decimal_places": 2
},
{
"id": "USD",
"description": "Dólar",
"symbol": "US$",
"decimal_places": 2
},
{
"id": "UYU",
"description": "Peso Uruguayo",
"symbol": "$",
"decimal_places": 2
},
{
"id": "VEF",
"description": "Bolivar fuerte",
"symbol": "Bs.",
"decimal_places": 2
},
{
"id": "GTQ",
"description": "Quetzal Guatemalteco",
"symbol": "Q",
"decimal_places": 2
},
{
"id": "BOB",
"description": "Boliviano",
"symbol": "Bs",
"decimal_places": 2
},
{
"id": "HNL",
"description": "Lempira",
"symbol": "L",
"decimal_places": 0
},
{
"id": "NIO",
"description": "Córdoba",
"symbol": "C$",
"decimal_places": 0
},
{
"id": "PYG",
"description": "Guaraní",
"symbol": "₲",
"decimal_places": 0
},
{
"id": "CUC",
"description": "Peso Cubano Convertible",
"symbol": "$",
"decimal_places": 2
}
]
|
| /currencies/$CURRENCY_ID |
Returns information about available currencies in Mercado Libre by currency_id. |
GET
Go back
X
Get currency details.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/currencies/CLP
Response
{
"id": "CLP",
"description": "Peso Chileno",
"symbol": "$",
"decimal_places": 0
}
Learn more.
|
| /currency_conversions/search?from=$CURRENCY_ID&to=$CURRENCY_ID |
Retrieves the conversion ratio between currencies that MercadoLibre uses in calculations. |
GET
Go back
X
Get ratio conversion between currencies.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/currency_conversions/search?from=ARS&to=CLP
Response
{
"ratio": 44.4378205,
"mercado_pago_ratio": 69.6783605
}
|
| /countries/$COUNTRY_ID/zip_codes/$ZIP_CODE |
Retrieves data for the location of the zip code entered. |
GET
Go back
X
Get location information by zip code.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/countries/AR/zip_codes/5000
Response
{
"zip_code": "5000",
"city": {
"id": null,
"name": null
},
"state": {
"id": "AR-X",
"name": "Córdoba"
},
"country": {
"id": "AR",
"name": "Argentina"
}
}
|
| /country/$COUNTRY_ID/zip_codes/search_between?zip_code_from=$ZIP_CODE_FROM&zip_code_to=$ZIP_CODE_TO |
Retrieve all zip codes for a country_id between two given zip codes. |
GET
Go back
X
Get all zip codes between two given values of zip codes.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/country/AR/zip_codes/search_between?zip_code_from=5000&zip_code_to=5100
Response
{
"zip_code": "5000",
"city": {
"id": null,
"name": null
},
"state": {
"id": "AR-X",
"name": "Córdoba"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"extended_attributes": {
"address": null,
"owner_name": null,
"zip_code_type": {
"type": null,
"description": null
},
"city_type": null,
"city_name": null,
"neighborhood": null,
"status": null,
"version": null
}
}
|
