Locations & Currencies

This examples will help you work with available locations and currencies of MercadoLibre.

Resource Description Example
/classified_locations/countries * Returns countries information. GET
Go back X

Get information about countries.

$ curl -X GET 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 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 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 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 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": "U$S",
    "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 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 https://api.mercadolibre.com/currency_conversions/search?from=ARS&to=CLP
 

Respuesta

{
  "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 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 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
  }
}

* Exclusive features of Classified Ads (categories of Real Estate, Vehicles and Services).

or register to recieve the latest news about our API