Reference codebooks · lookupReferencePeIneiUbigeo
OpenAPI

Peru district geography codebook

GET https://api.latinfo.dev/pe/inei/ubigeo/{code}

A district code and administrative hierarchy with reference coordinates. Use the six-digit UBIGEO district code. Preserve leading zeros. Coordinates locate the district reference point, not a company establishment.

Contrato de la fuente

Publicador
INEI; augmented codebook by Jose M. Castagnetto
Cobertura
Peruvian districts in the augmented UBIGEO codebook.
Qué representa un registro
A district code and administrative hierarchy with reference coordinates.
Identificador
Use the six-digit UBIGEO district code. Preserve leading zeros.
Patrón admitido
^\d{6}$
Cantidad de registros
one
Licencia
No se ha verificado el permiso de reutilización. El acceso público no equivale a una licencia de reutilización.

Limitaciones conocidas

  • Coordinates locate the district reference point, not a company establishment.

Contrato de la fuente para agentes · Documentación de la fuente

Requiere autenticación. Las solicitudes REST usan una clave de api de Latinfo. La consola agrega el encabezado de autorización y no guarda la clave.

Parámetros

codestringpathobligatorio

Use the six-digit UBIGEO district code. Preserve leading zeros.

Example: 130101

Ejemplo de solicitud

curl https://api.latinfo.dev/pe/inei/ubigeo/130101 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respuestas

200Codebook entry; values and identifiers remain strings.
Content-Type: application/json

Campos de la respuesta

ubigeo string obligatorio
departamento string obligatorio

Published department name.

provincia string obligatorio

Published province name.

distrito string obligatorio

Published district name.

latitude string obligatorio

District reference latitude; not the company coordinates.

longitude string obligatorio

District reference longitude; not the company coordinates.

Esquema de respuesta
{
  "type": "object",
  "required": [
    "ubigeo",
    "departamento",
    "provincia",
    "distrito",
    "latitude",
    "longitude"
  ],
  "additionalProperties": false,
  "properties": {
    "ubigeo": {
      "type": "string"
    },
    "departamento": {
      "type": "string",
      "description": "Published department name."
    },
    "provincia": {
      "type": "string",
      "description": "Published province name."
    },
    "distrito": {
      "type": "string",
      "description": "Published district name."
    },
    "latitude": {
      "type": "string",
      "description": "District reference latitude; not the company coordinates."
    },
    "longitude": {
      "type": "string",
      "description": "District reference longitude; not the company coordinates."
    }
  }
}
400Invalid code format
No se documentó un cuerpo de respuesta.
401Clave de api ausente o inválida
No se documentó un cuerpo de respuesta.
404Code not in this reference snapshot
No se documentó un cuerpo de respuesta.
429Request limit exceeded
No se documentó un cuerpo de respuesta.
503Reference source unavailable
No se documentó un cuerpo de respuesta.
Ejemplo JSON

Ejemplo ilustrativo del esquema. No es una respuesta en vivo.

{
  "ubigeo": "string",
  "departamento": "string",
  "provincia": "string",
  "distrito": "string",
  "latitude": "string",
  "longitude": "string"
}

Procedencia y limitaciones

La cobertura varía por país y fuente pública. Un campo ausente no demuestra que el hecho no exista. Los registros públicos pueden tener retrasos o errores; revisa la evidencia y la fecha de la fuente antes de usar un resultado.