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

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

Inicio rápido

Base URL

https://api.dataestado.cl/v1

Las rutas públicas viven bajo /v1. Si hay un cambio incompatible, se publica una nueva versión.

curl -s https://api.dataestado.cl/v1/ministries

Endpoints disponibles

GET /v1/ministries

Lista ministerios vigentes y sus autoridades en ejercicio.

GET /v1/ministries/:id/history

Historial cronológico de designaciones para el ministerio indicado.

GET /health

Estado del servicio.

GET /health/db

Estado de conexión con PostgreSQL.

Ejemplos de respuesta

Todos los tiempos se entregan en formato ISO 8601.

[
  {
    "id": 1,
    "orden": 1,
    "codigo": "interior",
    "nombre": "Ministerio del Interior",
    "sigla": null,
    "sitioWeb": "https://www.interior.gob.cl",
    "autoridades": [
      {
        "nombres": "Nombre",
        "apellidos": "Apellido",
        "cargo": "Ministro/a de Ministerio del Interior",
        "genero": null,
        "fechaInicio": "2026-03-11T00:00:00.000Z",
        "fechaTermino": null
      }
    ]
  }
]

Errores

Los errores se devuelven en JSON estable. Ejemplo de 404:

{
  "code": "not_found",
  "message": "Ministerio no encontrado",
  "resource": "ministerio",
  "id": "9999"
}

Referencia técnica

Swagger/OpenAPI se genera automáticamente desde el backend y funciona como referencia de contrato técnico.

/swagger

UI interactiva de endpoints

/swagger/json

Especificación OpenAPI 3.0.3

Convenciones

API de solo lectura.
Fechas en formato ISO 8601.
Cambios incompatibles solo en nuevas versiones.
El historial no implica subrogancias salvo que estén explícitas en la fuente.