Ubigeo, uso y estado

Tres endpoints que no gastan consultas.

GET /v1/ubigeo/{codigo}

Traduce un código INEI de 6 dígitos. Requiere clave; no gasta cuota.

{ "ubigeo": "150101", "departamento": "LIMA", "provincia": "LIMA", "distrito": "LIMA" }

GET /v1/uso

Tu plan, tu consumo del periodo y tus límites. Útil para tableros o para frenar a tiempo.

{
  "plan": "basico",
  "periodo": { "clave": "p2026-10-23T14:05", "fin": "2026-11-22T14:05:00.000Z" },
  "cuota": 60000, "usadas": 1834, "restantes": 58166, "creditos": 0,
  "limites": { "porSegundo": 5, "porMinuto": 120, "lote": 0 }
}

GET /v1/estado

Público, sin clave. Dice de qué fecha es el padrón y si está al día.

{ "disponible": true, "fechaPadron": "2026-10-23", "filas": 18483777, "cargadoEn": "2026-10-23T10:04:51.000Z", "actualizado": true }