Saltar al contenido principal

DataEstado

Github

Documentación

API pública y versionada de autoridades del Estado de Chile

DataEstado expone datos históricos y actuales de autoridades, ministerios y gobiernos con foco en estabilidad de contrato, trazabilidad histórica y consumo por sistemas externos.

Inicio rápido

Todas las rutas públicas estables viven bajo /v1.

Base URL

https://api.dataestado.cl/v1
curl -s https://api.dataestado.cl/v1/autoridades?gobierno=Boric

Qué información puedes extraer

Autoridades registradas desde 1990 hasta el presente.
Nombres, apellidos, cargo, ministerio, género registrado y gobierno asociado.
Fechas de inicio y término de cada designación.
Historial por gobierno y por ministerio.
Personas registradas y trayectoria de cargos por persona.
Ministerios vigentes, siglas, códigos internos y sitios web oficiales cuando están disponibles.
Estadísticas agregadas por gobierno para consumo rápido en dashboards o análisis exploratorio.

Endpoints disponibles

Para integraciones nuevas, prefiere las rutas canónicas en español.

GET/v1/autoridades Canónico

Listado completo de ministros y subsecretarios registrados, con filtro opcional por gobierno.

GET/v1/autoridades?gobierno=Frei Canónico

Búsqueda por gobierno usando coincidencia parcial e insensible a mayúsculas.

GET/v1/autoridades/gobierno/:nombre Canónico

Autoridades asociadas a un gobierno específico.

GET/v1/autoridades/ministerio/:nombre Canónico

Historial de autoridades asociado a un ministerio, usando búsqueda parcial por nombre.

GET/v1/personas Canónico

Listado paginado de personas registradas, con búsqueda opcional por nombre.

GET/v1/personas/:id Canónico

Ficha resumida de una persona con conteo y rango de designaciones registradas.

GET/v1/personas/:id/trayectoria Canónico

Trayectoria de cargos, ministerios, gobiernos y fechas para una persona registrada.

GET/v1/gobiernos Canónico

Gobiernos disponibles, presidentes y rangos presidenciales.

GET/v1/autoridades/estadisticas Canónico

Agregados por gobierno: designaciones, personas, ministros y subsecretarios.

GET/v1/ministerios Canónico

Ministerios vigentes con autoridades actuales. Ruta canónica para integraciones nuevas.

GET/v1/ministerios/:id Canónico

Ficha completa de un ministerio: datos vigentes, denominaciones históricas, cargos asociados y autoridades vigentes.

GET/v1/ministerios/:id/historial Canónico

Historial canónico de autoridades por ID de ministerio vigente, incluyendo persona_id y gobierno por tramo.

GET/v1/ministerios/codigo/:codigo Canónico

Ficha completa de un ministerio por código estable (ej: min-hacienda). Alternativa preferida a /v1/ministerios/:id.

GET/v1/autoridades/ministerio/codigo/:codigo Canónico

Autoridades de un ministerio por código estable, con paginación.

GET/v1/search Canónico

Búsqueda global en ministerios, personas, autoridades y gobiernos.

GET/health

Estado básico del servicio.

GET/health/db

Estado de conectividad con PostgreSQL.

Ejemplos de respuesta

GET /v1/autoridades?gobierno=Boric

[
  {
    "persona_id": 123,
    "nombres": "Nombre",
    "apellidos": "Apellido",
    "cargo": "Ministro/a de Hacienda",
    "ministerio": "Ministerio de Hacienda",
    "fecha_inicio": "2022-03-11T00:00:00.000Z",
    "fecha_termino": null,
    "genero": null,
    "gobierno": "Boric"
  }
]

GET /v1/gobiernos

[
  {
    "nombre": "Frei",
    "presidente": "Eduardo Frei Ruiz-Tagle",
    "fecha_inicio": "1994-03-11T00:00:00.000Z",
    "fecha_termino": "2000-03-11T00:00:00.000Z"
  }
]

Referencia técnica

Swagger/OpenAPI se genera desde el backend y funciona como referencia técnica del contrato. La documentación de esta página resume los casos de uso y convenciones principales.

/swagger

UI interactiva de endpoints

/swagger/json

Especificación OpenAPI

Convenciones y límites

  • API pública de solo lectura.
  • Contrato versionado bajo /v1.
  • Fechas en ISO 8601, normalizadas a UTC cuando se serializan como JSON.
  • Campos snake_case en los endpoints canónicos en español.
  • Listados potencialmente grandes deben usar paginación cuando el endpoint la ofrece, como /v1/personas; este endpoint expone total y has_more.
  • El proyecto apunta a ser open source: la documentación pública prioriza contrato, datos disponibles y uso; no detalles operativos internos innecesarios.
  • El historial no implica subrogancias salvo que estén explícitas en la fuente cargada.