Formularios de dirección en cascada
Departamento, provincia y distrito como listas dependientes, siempre con los nombres oficiales y el código correcto al final.
Finanzas y ubicación · Fuente: INEI
API de ubigeo y ubicación
Convierte un código de ubigeo en su departamento, provincia y distrito, o arma el código a partir de los nombres. Lista departamentos, provincias y distritos para formularios de dirección consistentes.
Cómo consultarla
Haz una petición GET con tu token en la cabecera Authorization y recibe la respuesta en JSON. Elige tu lenguaje, copia el código y reemplaza TU_TOKEN por el de tu cuenta.
GET https://api.endpoint.pe/v1/ubigeo/150101Obtener mi token gratisrespuesta.json
Qué datos devuelve
Fuente oficial: INEI. Cada respuesta trae siempre los mismos campos, en JSON.
ubigeoCódigo de ubigeo INEI de 6 dígitos.
ubigeo_reniecCódigo equivalente de RENIEC.
departamentoDepartamento.
provinciaProvincia.
distritoDistrito.
codigosCódigos de departamento, provincia y distrito por separado.
vigentefalse si el código ya no está en uso.
Qué es el ubigeo y para qué sirve esta API
El ubigeo es el código de seis dígitos con el que el INEI identifica cada departamento, provincia y distrito del Perú: dos dígitos por nivel. SUNAT lo usa en el domicilio fiscal de cada RUC y en los comprobantes electrónicos, y RENIEC usa una codificación propia para el domicilio del DNI.
La API de ubicación de endpoint.pe trabaja en los dos sentidos. Con un código devuelve el departamento, la provincia y el distrito, el código equivalente de RENIEC y si el código sigue vigente. Con los nombres arma el código paso a paso: sin parámetros lista los departamentos, con un departamento lista sus provincias, con departamento y provincia lista los distritos, y con los tres devuelve el ubigeo. Los nombres se aceptan con o sin tildes y sin importar mayúsculas.
Es la base para formularios de dirección en cascada y para validar que el ubigeo que vas a poner en un comprobante corresponde a un distrito real.
Para qué se usa la API de ubigeo y ubicación
Validar ubigeos en comprobantes
Comprueba que el código de seis dígitos existe y está vigente antes de enviarlo en una factura electrónica.
Cruzar INEI y RENIEC
Convierte entre el ubigeo de SUNAT y el de RENIEC cuando unes datos de empresas y de personas.
Preguntas frecuentes
Preguntas sobre la API de ubigeo y ubicación
Si tu duda no está aquí, escríbenos y te responde una persona del equipo.
Our Blog
Guías relacionadas en el blog
Cómo funcionan estos datos en el Perú y cómo integrarlos en tu sistema.
Ubigeo
Qué es el ubigeo y cómo leer sus seis dígitos
El ubigeo es el código de seis dígitos que identifica cada departamento, provincia y distrito del Perú. Qué significa cada par, ejemplos y cómo consultarlo.
Equipo endpoint.pe•15 jul. 2026
Ubigeo
Formularios de dirección en el Perú: cómo armarlos bien
Cómo diseñar un formulario de dirección para el Perú: selects en cascada de departamento, provincia y distrito, búsqueda por nombre y guardado del ubigeo.
Equipo endpoint.pe•25 jul. 2026
Ubigeo
Ubigeo INEI vs ubigeo RENIEC: por qué no coinciden
Dos codificaciones de ubigeo conviven en el Perú: INEI y RENIEC. Qué las diferencia, cuál usa SUNAT y cómo mapear una a otra sin cruzar mal tus bases de datos.
Equipo endpoint.pe•20 jul. 2026
Ubigeo
Lima Metropolitana, Callao y Lima provincias en el ubigeo
Lima departamento, provincia de Lima y Callao tienen códigos de ubigeo distintos. Aprende a diferenciarlos y a filtrar Lima Metropolitana en tu sistema.
Equipo endpoint.pe•30 jul. 2026Deja de copiar datos a mano.
Automatízalo hoy mismo
Crea tu cuenta, copia tu token y empieza hoy con 150 consultas gratis al mes.