Países e idiomas

Países activos, con su prefijo telefónico y sus divisiones territoriales, e idiomas disponibles.

2 min de lecturaActualizado el 30 de setiembre de 2026

Países

GET /api/v1/ecommerce/countries

No pide token.

Parámetro Dónde Obligatorio Reglas
id Query No Código de 2 letras, por ejemplo PE. Devuelve solo ese país
description Query No Busca países cuyo nombre contenga el texto. Máximo 100 caracteres

Respuesta

{
  "success": true,
  "message": "Listado de países disponibles mostrados de forma correcta.",
  "data": [
    {
      "id": "PE",
      "description": "Peru",
      "default": true,
      "code": "+51",
      "mask": "999 999 999",
      "flag": "https://miempresa.ejemplo.com/images/pe.svg",
      "national_division": ["Departamento", "Provincia", "Distrito"]
    }
  ]
}
Campo Qué es
id Código del país. Es el valor que se envía como country_id en el resto de la API
default Si es el país por defecto de la tienda
code Prefijo telefónico
mask Formato del número de teléfono, para el campo del formulario
national_division Nombres de los niveles territoriales del país, en orden, o null. Se usan como national_division en las direcciones

Solo aparecen los países activos.

Si algo sale mal

HTTP code Cuándo Qué hacer
422 VALIDATION_ERROR id no tiene 2 letras o description es demasiado largo Corrige el filtro

Idiomas

GET /api/v1/ecommerce/langs

No pide token ni recibe parámetros.

{
  "success": true,
  "message": "Listado de idiomas mostrados de forma correcta.",
  "data": [ { "id": "es", "description": "Español" }, { "id": "en", "description": "Ingles" } ]
}

El id es el valor que se guarda como idioma en las preferencias del cliente (extras.lang en el perfil).