Comunas y Regiones de Chile

Estos endpoints permiten obtener el catálogo completo de división político-administrativa de Chile. Los datos incluyen códigos SII, códigos BHE y relaciones entre comunas y regiones.

Son útiles para poblar selectores en formularios, validar datos de entrada, o sincronizar catálogos con tu sistema.

Requisitos Previos

Estos endpoints exigen una credencial válida, sin ningún rol en particular: sirve cualquier API Key de tu empresa, y también la sesión de un usuario en la aplicación web. La respuesta es idéntica para todos.

Hasta agosto de 2026 estas rutas colgaban de la raíz (/comunas, /regiones, /comunas-regiones) y respondían sin credencial. Hoy viven bajo /global/ y exigen identidad.

Si llamás a una dirección anterior con tu API Key vas a recibir un 403 — API_KEY_TENANT_MISMATCH con credencial de máquina, Access denied for the requested tenant con sesión. No es un problema de tu credencial, de tu empresa ni de tus permisos: es que la ruta se movió, y su primer segmento pasó a leerse como el nombre de una empresa. Cambiá la URL a /global/… y funciona.

Ese mensaje es deliberadamente inespecífico —es el mismo que devuelve cualquier empresa que no existe, para que nadie pueda enumerar empresas probando URLs—, así que la respuesta no puede decírtelo. Por eso está escrito acá.

Endpoints

GET /global/regiones

Retorna las 16 regiones de Chile.

Request

GET /global/regiones

Headers

Authorization: Bearer {api_key}

Ejemplo con curl

curl -X GET "https://api.redcumbre.cl/global/regiones" \
  -H "Authorization: Bearer {api_key}"

Respuesta Exitosa (200)

{
  "success": true,
  "data": [
    { "id": 1, "nombre": "Tarapacá" },
    { "id": 2, "nombre": "Antofagasta" },
    { "id": 3, "nombre": "Atacama" },
    { "id": 4, "nombre": "Coquimbo" },
    { "id": 5, "nombre": "Valparaíso" },
    { "id": 6, "nombre": "O'Higgins" },
    { "id": 7, "nombre": "Maule" },
    { "id": 8, "nombre": "Biobío" },
    { "id": 9, "nombre": "La Araucanía" },
    { "id": 10, "nombre": "Los Lagos" },
    { "id": 11, "nombre": "Aysén" },
    { "id": 12, "nombre": "Magallanes" },
    { "id": 13, "nombre": "Metropolitana" },
    { "id": 14, "nombre": "Los Ríos" },
    { "id": 15, "nombre": "Arica y Parinacota" },
    { "id": 16, "nombre": "Ñuble" }
  ]
}

Campos de Región

Campo	Tipo	Descripción
`id`	number	ID de la región (1-16)
`nombre`	string	Nombre oficial de la región

GET /global/comunas

Retorna las 346 comunas de Chile con información detallada.

Request

GET /global/comunas

Headers

Authorization: Bearer {api_key}

Ejemplo con curl

curl -X GET "https://api.redcumbre.cl/global/comunas" \
  -H "Authorization: Bearer {api_key}"

Respuesta Exitosa (200)

{
  "success": true,
  "data": [
    {
      "id": 1,
      "nombre": "Arica",
      "numero": 1101,
      "codigoSii": "15101",
      "regionId": 15,
      "regionNombre": "Arica y Parinacota",
      "bheCodigo": 15101,
      "bheNombre": "ARICA",
      "bheRegionCodigo": 15,
      "bheRegionNombre": "ARICA Y PARINACOTA",
      "unidadSii": {
        "direccionRegional": "Dirección Regional de Arica y Parinacota",
        "nombreCorto": "DR Arica y Parinacota",
        "codigoRegion": "15",
        "unidad": "Unidad de Arica"
      }
    }
  ]
}

Campos de Comuna

Campo	Tipo	Descripción
`id`	number	ID secuencial de la comuna
`nombre`	string	Nombre oficial de la comuna
`numero`	number	Código numérico de la comuna
`codigoSii`	string	Código SII de la comuna (5 dígitos)
`regionId`	number	ID de la región a la que pertenece
`regionNombre`	string	Nombre de la región
`bheCodigo`	number	Código BHE de la comuna
`bheNombre`	string	Nombre de la comuna según BHE
`bheRegionCodigo`	number	Código de región según BHE
`bheRegionNombre`	string	Nombre de región según BHE
`unidadSii`	object \| null	Información de la unidad SII correspondiente

Estructura de Unidad SII

Campo	Tipo	Descripción
`direccionRegional`	string	Nombre de la Dirección Regional
`nombreCorto`	string	Nombre corto de la DR
`codigoRegion`	string	Código de la región
`unidad`	string	Nombre de la unidad SII

GET /global/comunas-regiones

Retorna ambos listados en una sola llamada. Útil para cargar todos los datos de una vez.

Request

GET /global/comunas-regiones

Headers

Authorization: Bearer {api_key}

Ejemplo con curl

curl -X GET "https://api.redcumbre.cl/global/comunas-regiones" \
  -H "Authorization: Bearer {api_key}"

Respuesta Exitosa (200)

{
  "success": true,
  "data": {
    "regiones": [
      { "id": 1, "nombre": "Tarapacá" },
      { "id": 2, "nombre": "Antofagasta" }
    ],
    "comunas": [
      {
        "id": 1,
        "nombre": "Arica",
        "regionId": 15,
        "codigoSii": "15101"
      }
    ]
  }
}

Casos de Uso

Poblar Selectores en Formularios

Usa /global/comunas-regiones para cargar ambos catálogos y crear selectores dependientes:

const response = await fetch('https://api.redcumbre.cl/global/comunas-regiones', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});

const { data } = await response.json();

// Poblar selector de regiones
const regionSelect = document.getElementById('region');
data.regiones.forEach(region => {
  const option = new Option(region.nombre, region.id);
  regionSelect.add(option);
});

// Filtrar comunas por región seleccionada
regionSelect.addEventListener('change', (e) => {
  const comunaSelect = document.getElementById('comuna');
  comunaSelect.innerHTML = '';

  const comunasFiltradas = data.comunas.filter(c => c.regionId === parseInt(e.target.value));
  comunasFiltradas.forEach(comuna => {
    const option = new Option(comuna.nombre, comuna.codigoSii);
    comunaSelect.add(option);
  });
});

Obtener Código SII de una Comuna

Para enviar datos al SII necesitas el codigoSii de la comuna:

const comunas = await fetch('https://api.redcumbre.cl/global/comunas', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
}).then(r => r.json());

const santiago = comunas.data.find(c => c.nombre === 'Santiago');
console.log(santiago.codigoSii); // "13101"

Validar Código de Comuna

Verifica que un código de comuna sea válido antes de enviar datos:

function validarCodigoComuna(codigo, comunas) {
  return comunas.some(c => c.codigoSii === codigo);
}

Códigos de Error

Código	Descripción	Causa
401	No autorizado	API Key inválida, expirada, revocada o no proporcionada
403	Acceso denegado	Estás llamando a la dirección anterior (`/comunas`, `/regiones`, `/comunas-regiones`) en vez de a `/global/…`. Tu credencial está bien
404	No encontrado	La ruta no existe. Revisá que el prefijo sea `/global/`

👉 Ver endpoints en Swagger