NexoID

API de ubigeo

De un código de ubigeo a su departamento, provincia y distrito

El catálogo del INEI, para resolver los códigos de seis dígitos de tus formularios. Y en la ficha de RUC ya viene resuelto: no necesitas una segunda consulta.

Petición
curl https://nexoid.victorllerena.com/id/v1/ubigeo/150131 \
  -H "Authorization: Bearer $NEXOID_TOKEN"
Respuesta · 200
{
  "success": true,
  "data": {
    "codigo": "150131",
    "departamento": "LIMA",
    "provincia": "LIMA",
    "distrito": "SAN BORJA"
  }
}

Endpoints

  • GET /id/v1/ubigeo/{codigo}

    Un código de seis dígitos · desde el plan gratis

Qué devuelve

CampoQué esPresente en
codigoEl código INEI de seis dígitossiempre
departamentoNombre del departamentosiempre
provinciaNombre de la provinciasiempre
distritoNombre del distritosiempre

Preguntas frecuentes

¿Viene el ubigeo en la ficha de RUC?
Sí, en el 82.6 % de las fichas, con el departamento, la provincia y el distrito ya resueltos. Esta API es para los códigos que ya tienes de otra fuente.
¿Cada cuánto se actualiza el catálogo?
Se sincroniza cada mes, con lo que publica el INEI.