{"openapi":"3.0.3","info":{"title":"dataestado API","description":"API pública de solo lectura sobre instituciones y autoridades del Estado de Chile. Incluye ministerios vigentes y autoridades registradas desde 1973 hasta el presente, consultables mediante endpoints canónicos en español.","version":"1.2.0","contact":{"name":"DataEstado API Support","url":"https://github.com/juliodelfos/dataestado"},"license":{"name":"MIT","url":"https://github.com/juliodelfos/dataestado/blob/main/LICENSE"}},"servers":[{"url":"https://api.dataestado.cl","description":"Producción"},{"url":"http://localhost:3001","description":"Desarrollo local"}],"tags":[{"name":"Salud","description":"Endpoints de monitoreo del servicio y de la conexión a la base de datos."},{"name":"Ministerios","description":"Consulta canónica en español de ministerios vigentes y autoridades actuales."},{"name":"Autoridades","description":"Consulta de autoridades registradas, con filtros por gobierno y ministerio usando el contrato canónico en español."},{"name":"Personas","description":"Consulta canónica de personas registradas y sus trayectorias públicas."},{"name":"Gobiernos","description":"Información sobre gobiernos y períodos presidenciales disponibles en la base de datos."},{"name":"Estadísticas","description":"Estadísticas agregadas de autoridades."},{"name":"Búsqueda","description":"Búsqueda global en ministerios, personas y autoridades."}],"paths":{"/health":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"timestamp":{"type":"string"}},"required":["ok","service","timestamp"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"timestamp":{"type":"string"}},"required":["ok","service","timestamp"]}},"text/plain":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"timestamp":{"type":"string"}},"required":["ok","service","timestamp"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getHealth","summary":"Estado general del servicio","description":"Devuelve estado de la API, nombre del servicio y timestamp en formato ISO 8601.","tags":["Salud"]}},"/health/db":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"number"}},"required":["ok"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"ok":{"type":"number"}},"required":["ok"]}},"text/plain":{"schema":{"type":"object","properties":{"ok":{"type":"number"}},"required":["ok"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getHealthDb","summary":"Estado de conexión a base de datos","description":"Verifica conectividad con PostgreSQL ejecutando una consulta simple.","tags":["Salud"]}},"/v1/ministerios":{"get":{"responses":{"200":{"items":{"type":"object","required":["id","orden","codigo","nombre","sigla","sitio_web","autoridades"],"properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno estable del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial del ministerio, si existe.","type":"string"},{"type":"null"}]},"autoridades":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["id","orden","codigo","nombre","sigla","sitio_web","autoridades"],"properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno estable del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial del ministerio, si existe.","type":"string"},{"type":"null"}]},"autoridades":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}}}}},"multipart/form-data":{"schema":{"type":"array","items":{"type":"object","required":["id","orden","codigo","nombre","sigla","sitio_web","autoridades"],"properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno estable del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial del ministerio, si existe.","type":"string"},{"type":"null"}]},"autoridades":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}}}}},"text/plain":{"schema":{"type":"array","items":{"type":"object","required":["id","orden","codigo","nombre","sigla","sitio_web","autoridades"],"properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno estable del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial del ministerio, si existe.","type":"string"},{"type":"null"}]},"autoridades":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}}}}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1Ministerios","summary":"Listado canónico de ministerios vigentes","description":"Entrega ministerios vigentes con autoridades actualmente en ejercicio. Ruta canónica en español para integraciones nuevas.","tags":["Ministerios"]}},"/v1/ministerios/codigo/{codigo}":{"get":{"parameters":[{"description":"Código estable del ministerio (ej: min-hacienda, min-educacion).","schema":{"type":"string"},"in":"path","name":"codigo","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno estable del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial vigente del ministerio, si existe.","type":"string"},{"type":"null"}]},"denominaciones":{"type":"array","items":{"type":"object","required":["nombre","sigla","sitio_web","fecha_inicio","fecha_termino"],"properties":{"nombre":{"description":"Nombre histórico del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla histórica, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial en el período, si existe.","type":"string"},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de vigencia de la denominación.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de vigencia de la denominación.","format":"date-time","type":"string"},{"type":"null"}]}}}},"cargos":{"type":"array","items":{"type":"object","required":["id","nombre","tipo_cargo","fecha_inicio","fecha_termino"],"properties":{"id":{"description":"Identificador numérico del cargo.","type":"number"},"nombre":{"description":"Nombre histórico del cargo.","type":"string"},"tipo_cargo":{"description":"Clasificación estable del cargo: ministro, subsecretario u otro.","type":"string"},"fecha_inicio":{"description":"Fecha desde la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha hasta la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},{"type":"null"}]}}}},"autoridades_vigentes":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}},"required":["id","orden","codigo","nombre","sigla","sitio_web","denominaciones","cargos","autoridades_vigentes"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno estable del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial vigente del ministerio, si existe.","type":"string"},{"type":"null"}]},"denominaciones":{"type":"array","items":{"type":"object","required":["nombre","sigla","sitio_web","fecha_inicio","fecha_termino"],"properties":{"nombre":{"description":"Nombre histórico del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla histórica, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial en el período, si existe.","type":"string"},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de vigencia de la denominación.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de vigencia de la denominación.","format":"date-time","type":"string"},{"type":"null"}]}}}},"cargos":{"type":"array","items":{"type":"object","required":["id","nombre","tipo_cargo","fecha_inicio","fecha_termino"],"properties":{"id":{"description":"Identificador numérico del cargo.","type":"number"},"nombre":{"description":"Nombre histórico del cargo.","type":"string"},"tipo_cargo":{"description":"Clasificación estable del cargo: ministro, subsecretario u otro.","type":"string"},"fecha_inicio":{"description":"Fecha desde la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha hasta la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},{"type":"null"}]}}}},"autoridades_vigentes":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}},"required":["id","orden","codigo","nombre","sigla","sitio_web","denominaciones","cargos","autoridades_vigentes"]}},"text/plain":{"schema":{"type":"object","properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno estable del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial vigente del ministerio, si existe.","type":"string"},{"type":"null"}]},"denominaciones":{"type":"array","items":{"type":"object","required":["nombre","sigla","sitio_web","fecha_inicio","fecha_termino"],"properties":{"nombre":{"description":"Nombre histórico del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla histórica, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial en el período, si existe.","type":"string"},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de vigencia de la denominación.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de vigencia de la denominación.","format":"date-time","type":"string"},{"type":"null"}]}}}},"cargos":{"type":"array","items":{"type":"object","required":["id","nombre","tipo_cargo","fecha_inicio","fecha_termino"],"properties":{"id":{"description":"Identificador numérico del cargo.","type":"number"},"nombre":{"description":"Nombre histórico del cargo.","type":"string"},"tipo_cargo":{"description":"Clasificación estable del cargo: ministro, subsecretario u otro.","type":"string"},"fecha_inicio":{"description":"Fecha desde la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha hasta la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},{"type":"null"}]}}}},"autoridades_vigentes":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}},"required":["id","orden","codigo","nombre","sigla","sitio_web","denominaciones","cargos","autoridades_vigentes"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1MinisteriosCodigoByCodigo","summary":"Ficha canónica de un ministerio por código","description":"Retorna información vigente e histórica de un ministerio usando su código estable (ej: min-hacienda).","tags":["Ministerios"]}},"/v1/ministerios/{id}":{"get":{"parameters":[{"description":"ID numérico positivo del ministerio.","schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno estable del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial vigente del ministerio, si existe.","type":"string"},{"type":"null"}]},"denominaciones":{"type":"array","items":{"type":"object","required":["nombre","sigla","sitio_web","fecha_inicio","fecha_termino"],"properties":{"nombre":{"description":"Nombre histórico del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla histórica, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial en el período, si existe.","type":"string"},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de vigencia de la denominación.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de vigencia de la denominación.","format":"date-time","type":"string"},{"type":"null"}]}}}},"cargos":{"type":"array","items":{"type":"object","required":["id","nombre","tipo_cargo","fecha_inicio","fecha_termino"],"properties":{"id":{"description":"Identificador numérico del cargo.","type":"number"},"nombre":{"description":"Nombre histórico del cargo.","type":"string"},"tipo_cargo":{"description":"Clasificación estable del cargo: ministro, subsecretario u otro.","type":"string"},"fecha_inicio":{"description":"Fecha desde la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha hasta la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},{"type":"null"}]}}}},"autoridades_vigentes":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}},"required":["id","orden","codigo","nombre","sigla","sitio_web","denominaciones","cargos","autoridades_vigentes"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno estable del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial vigente del ministerio, si existe.","type":"string"},{"type":"null"}]},"denominaciones":{"type":"array","items":{"type":"object","required":["nombre","sigla","sitio_web","fecha_inicio","fecha_termino"],"properties":{"nombre":{"description":"Nombre histórico del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla histórica, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial en el período, si existe.","type":"string"},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de vigencia de la denominación.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de vigencia de la denominación.","format":"date-time","type":"string"},{"type":"null"}]}}}},"cargos":{"type":"array","items":{"type":"object","required":["id","nombre","tipo_cargo","fecha_inicio","fecha_termino"],"properties":{"id":{"description":"Identificador numérico del cargo.","type":"number"},"nombre":{"description":"Nombre histórico del cargo.","type":"string"},"tipo_cargo":{"description":"Clasificación estable del cargo: ministro, subsecretario u otro.","type":"string"},"fecha_inicio":{"description":"Fecha desde la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha hasta la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},{"type":"null"}]}}}},"autoridades_vigentes":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}},"required":["id","orden","codigo","nombre","sigla","sitio_web","denominaciones","cargos","autoridades_vigentes"]}},"text/plain":{"schema":{"type":"object","properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno estable del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial vigente del ministerio, si existe.","type":"string"},{"type":"null"}]},"denominaciones":{"type":"array","items":{"type":"object","required":["nombre","sigla","sitio_web","fecha_inicio","fecha_termino"],"properties":{"nombre":{"description":"Nombre histórico del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla histórica, si aplica.","type":"string"},{"type":"null"}]},"sitio_web":{"nullable":true,"anyOf":[{"description":"Sitio web oficial en el período, si existe.","type":"string"},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de vigencia de la denominación.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de vigencia de la denominación.","format":"date-time","type":"string"},{"type":"null"}]}}}},"cargos":{"type":"array","items":{"type":"object","required":["id","nombre","tipo_cargo","fecha_inicio","fecha_termino"],"properties":{"id":{"description":"Identificador numérico del cargo.","type":"number"},"nombre":{"description":"Nombre histórico del cargo.","type":"string"},"tipo_cargo":{"description":"Clasificación estable del cargo: ministro, subsecretario u otro.","type":"string"},"fecha_inicio":{"description":"Fecha desde la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha hasta la que el cargo pertenece al ministerio.","format":"date-time","type":"string"},{"type":"null"}]}}}},"autoridades_vigentes":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}},"required":["id","orden","codigo","nombre","sigla","sitio_web","denominaciones","cargos","autoridades_vigentes"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1MinisteriosById","summary":"Ficha canónica de un ministerio","description":"Retorna información vigente e histórica de un ministerio: denominaciones, cargos asociados y autoridades vigentes.","tags":["Ministerios"]}},"/v1/ministerios/{id}/historial":{"get":{"parameters":[{"description":"ID numérico positivo del ministerio.","schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true}],"responses":{"200":{"items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}},"multipart/form-data":{"schema":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}},"text/plain":{"schema":{"type":"array","items":{"type":"object","required":["persona_id","nombres","apellidos","cargo","genero","partido_politico","fecha_inicio","fecha_termino","gobierno"],"properties":{"persona_id":{"description":"Identificador numérico de la persona asociada.","type":"number"},"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno asociado a la designación, cuando puede resolverse por fecha.","type":"string"},{"type":"null"}]}}}}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1MinisteriosByIdHistorial","summary":"Historial canónico de autoridades por ministerio","description":"Retorna historial cronológico de designaciones para un ministerio vigente. Ruta canónica en español para integraciones nuevas.","tags":["Ministerios"]}},"/v1/autoridades":{"get":{"parameters":[{"description":"Filtro opcional por gobierno. Ej: \"Dictadura Militar\", \"Frei\", \"Lagos\", \"Bachelet I\", \"Boric\", \"Kast\".","schema":{"type":"string"},"in":"query","name":"gobierno","required":false},{"description":"Cantidad máxima de registros por página.","schema":{"default":100,"minimum":1,"maximum":500,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"description":"Cantidad máxima de registros por página.","default":100,"minimum":1,"maximum":500,"type":"number"}]},"in":"query","name":"limit","required":true},{"description":"Cantidad de registros a saltar.","schema":{"default":0,"minimum":0,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"description":"Cantidad de registros a saltar.","default":0,"minimum":0,"type":"number"}]},"in":"query","name":"offset","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}},"text/plain":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1Autoridades","summary":"Listado de autoridades (ministros y subsecretarios)","description":"Retorna el listado paginado de todas las autoridades registradas (ministros y subsecretarios). Incluye datos desde 1973 hasta el presente.","tags":["Autoridades"]}},"/v1/autoridades/ministerio/codigo/{codigo}":{"get":{"parameters":[{"description":"Código estable del ministerio. Ej: \"min-hacienda\", \"min-educacion\", \"min-salud\".","schema":{"type":"string","minLength":1},"in":"path","name":"codigo","required":true},{"description":"Cantidad máxima de registros por página.","schema":{"default":100,"minimum":1,"maximum":500,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"description":"Cantidad máxima de registros por página.","default":100,"minimum":1,"maximum":500,"type":"number"}]},"in":"query","name":"limit","required":true},{"description":"Cantidad de registros a saltar.","schema":{"default":0,"minimum":0,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"description":"Cantidad de registros a saltar.","default":0,"minimum":0,"type":"number"}]},"in":"query","name":"offset","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}},"text/plain":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1AutoridadesMinisterioCodigoByCodigo","summary":"Autoridades de un ministerio por código","description":"Retorna todas las autoridades (ministros y subsecretarios) de un ministerio específico usando su código estable. Incluye paginación.","tags":["Autoridades"]}},"/v1/autoridades/ministerio/{nombre}":{"get":{"parameters":[{"description":"Nombre del ministerio (búsqueda parcial insensible a mayúsculas). Ej: \"Justicia\", \"Educación\", \"Salud\".","schema":{"type":"string","minLength":1},"in":"path","name":"nombre","required":true},{"description":"Cantidad máxima de registros por página.","schema":{"default":100,"minimum":1,"maximum":500,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"description":"Cantidad máxima de registros por página.","default":100,"minimum":1,"maximum":500,"type":"number"}]},"in":"query","name":"limit","required":true},{"description":"Cantidad de registros a saltar.","schema":{"default":0,"minimum":0,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"description":"Cantidad de registros a saltar.","default":0,"minimum":0,"type":"number"}]},"in":"query","name":"offset","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}},"text/plain":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1AutoridadesMinisterioByNombre","summary":"Autoridades de un ministerio","description":"Retorna todas las autoridades (ministros y subsecretarios) de un ministerio específico. Incluye el historial completo desde 1973.","tags":["Autoridades"]}},"/v1/autoridades/gobierno/{nombre}":{"get":{"parameters":[{"description":"Nombre del gobierno (búsqueda parcial insensible a mayúsculas). Ej: \"Frei\", \"Lagos\", \"Bachelet I\", \"Boric\".","schema":{"type":"string","minLength":1},"in":"path","name":"nombre","required":true},{"description":"Cantidad máxima de registros por página.","schema":{"default":100,"minimum":1,"maximum":500,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"description":"Cantidad máxima de registros por página.","default":100,"minimum":1,"maximum":500,"type":"number"}]},"in":"query","name":"limit","required":true},{"description":"Cantidad de registros a saltar.","schema":{"default":0,"minimum":0,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"description":"Cantidad de registros a saltar.","default":0,"minimum":0,"type":"number"}]},"in":"query","name":"offset","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}},"text/plain":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado. Puede variar denominación según gobierno.","type":"string"},"ministerio":{"description":"Ministerio al que pertenecía la autoridad.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"nullable":true,"anyOf":[{"description":"Gobierno durante el cual ejerció (ej: \"Frei\", \"Lagos\", \"Boric\").","type":"string"},{"type":"null"}]}}}},"pagination":{"type":"object","required":["limit","offset","count","total"],"properties":{"limit":{"description":"Cantidad máxima de registros por página.","type":"number"},"offset":{"description":"Cantidad de registros a saltar.","type":"number"},"count":{"description":"Cantidad de registros devueltos en esta página.","type":"number"},"total":{"description":"Total de registros disponibles.","type":"number"}}}},"required":["data","pagination"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1AutoridadesGobiernoByNombre","summary":"Autoridades de un gobierno específico","description":"Retorna todas las autoridades (ministros y subsecretarios) de un gobierno específico.","tags":["Autoridades"]}},"/v1/gobiernos":{"get":{"responses":{"200":{"items":{"type":"object","required":["nombre","presidente","fecha_inicio","fecha_termino"],"properties":{"nombre":{"description":"Nombre del gobierno (ej: \"Frei\", \"Lagos\").","type":"string"},"presidente":{"description":"Nombre del presidente.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio del gobierno.","format":"date-time","type":"string"},"fecha_termino":{"description":"Fecha de término del gobierno.","format":"date-time","type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["nombre","presidente","fecha_inicio","fecha_termino"],"properties":{"nombre":{"description":"Nombre del gobierno (ej: \"Frei\", \"Lagos\").","type":"string"},"presidente":{"description":"Nombre del presidente.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio del gobierno.","format":"date-time","type":"string"},"fecha_termino":{"description":"Fecha de término del gobierno.","format":"date-time","type":"string"}}}}},"multipart/form-data":{"schema":{"type":"array","items":{"type":"object","required":["nombre","presidente","fecha_inicio","fecha_termino"],"properties":{"nombre":{"description":"Nombre del gobierno (ej: \"Frei\", \"Lagos\").","type":"string"},"presidente":{"description":"Nombre del presidente.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio del gobierno.","format":"date-time","type":"string"},"fecha_termino":{"description":"Fecha de término del gobierno.","format":"date-time","type":"string"}}}}},"text/plain":{"schema":{"type":"array","items":{"type":"object","required":["nombre","presidente","fecha_inicio","fecha_termino"],"properties":{"nombre":{"description":"Nombre del gobierno (ej: \"Frei\", \"Lagos\").","type":"string"},"presidente":{"description":"Nombre del presidente.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio del gobierno.","format":"date-time","type":"string"},"fecha_termino":{"description":"Fecha de término del gobierno.","format":"date-time","type":"string"}}}}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1Gobiernos","summary":"Lista de gobiernos disponibles","description":"Retorna la lista de todos los gobiernos registrados en la base de datos, con sus fechas y presidentes.","tags":["Gobiernos"]}},"/v1/autoridades/estadisticas":{"get":{"responses":{"200":{"items":{"type":"object","required":["gobierno","total_designaciones","total_personas","total_ministros","total_subsecretarios"],"properties":{"gobierno":{"type":"string"},"total_designaciones":{"type":"number"},"total_personas":{"type":"number"},"total_ministros":{"type":"number"},"total_subsecretarios":{"type":"number"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["gobierno","total_designaciones","total_personas","total_ministros","total_subsecretarios"],"properties":{"gobierno":{"type":"string"},"total_designaciones":{"type":"number"},"total_personas":{"type":"number"},"total_ministros":{"type":"number"},"total_subsecretarios":{"type":"number"}}}}},"multipart/form-data":{"schema":{"type":"array","items":{"type":"object","required":["gobierno","total_designaciones","total_personas","total_ministros","total_subsecretarios"],"properties":{"gobierno":{"type":"string"},"total_designaciones":{"type":"number"},"total_personas":{"type":"number"},"total_ministros":{"type":"number"},"total_subsecretarios":{"type":"number"}}}}},"text/plain":{"schema":{"type":"array","items":{"type":"object","required":["gobierno","total_designaciones","total_personas","total_ministros","total_subsecretarios"],"properties":{"gobierno":{"type":"string"},"total_designaciones":{"type":"number"},"total_personas":{"type":"number"},"total_ministros":{"type":"number"},"total_subsecretarios":{"type":"number"}}}}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1AutoridadesEstadisticas","summary":"Estadísticas de autoridades por gobierno","description":"Retorna estadísticas agregadas de autoridades agrupadas por gobierno.","tags":["Estadísticas"]}},"/v1/personas":{"get":{"parameters":[{"description":"Búsqueda opcional por nombre completo. No puede estar vacío.","schema":{"type":"string"},"in":"query","name":"q","required":false},{"description":"Cantidad máxima de resultados.","schema":{"default":50,"minimum":1,"maximum":200,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"description":"Cantidad máxima de resultados.","default":50,"minimum":1,"maximum":200,"type":"number"}]},"in":"query","name":"limit","required":true},{"description":"Desplazamiento de resultados.","schema":{"default":0,"minimum":0,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"description":"Desplazamiento de resultados.","default":0,"minimum":0,"type":"number"}]},"in":"query","name":"offset","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","nombres","apellidos","genero","total_designaciones","primera_designacion","ultima_designacion","homonimos"],"properties":{"id":{"description":"Identificador numérico estable de la persona.","type":"number"},"nombres":{"description":"Nombres registrados de la persona.","type":"string"},"apellidos":{"description":"Apellidos registrados de la persona.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"total_designaciones":{"description":"Cantidad de designaciones registradas para la persona.","type":"number"},"primera_designacion":{"nullable":true,"anyOf":[{"description":"Primera designación registrada en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"ultima_designacion":{"nullable":true,"anyOf":[{"description":"Última fecha registrada de ejercicio o inicio, en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"homonimos":{"description":"Cantidad de otras personas con el mismo nombre y apellidos normalizados.","type":"number"}},"additionalProperties":false}},"pagination":{"type":"object","required":["limit","offset","count","total","has_more"],"properties":{"limit":{"type":"number"},"offset":{"type":"number"},"count":{"type":"number"},"total":{"description":"Total de personas que cumplen el filtro actual.","type":"number"},"has_more":{"description":"Indica si existe una página siguiente con los parámetros actuales.","type":"boolean"}}}},"required":["data","pagination"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","nombres","apellidos","genero","total_designaciones","primera_designacion","ultima_designacion","homonimos"],"properties":{"id":{"description":"Identificador numérico estable de la persona.","type":"number"},"nombres":{"description":"Nombres registrados de la persona.","type":"string"},"apellidos":{"description":"Apellidos registrados de la persona.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"total_designaciones":{"description":"Cantidad de designaciones registradas para la persona.","type":"number"},"primera_designacion":{"nullable":true,"anyOf":[{"description":"Primera designación registrada en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"ultima_designacion":{"nullable":true,"anyOf":[{"description":"Última fecha registrada de ejercicio o inicio, en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"homonimos":{"description":"Cantidad de otras personas con el mismo nombre y apellidos normalizados.","type":"number"}},"additionalProperties":false}},"pagination":{"type":"object","required":["limit","offset","count","total","has_more"],"properties":{"limit":{"type":"number"},"offset":{"type":"number"},"count":{"type":"number"},"total":{"description":"Total de personas que cumplen el filtro actual.","type":"number"},"has_more":{"description":"Indica si existe una página siguiente con los parámetros actuales.","type":"boolean"}}}},"required":["data","pagination"]}},"text/plain":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","nombres","apellidos","genero","total_designaciones","primera_designacion","ultima_designacion","homonimos"],"properties":{"id":{"description":"Identificador numérico estable de la persona.","type":"number"},"nombres":{"description":"Nombres registrados de la persona.","type":"string"},"apellidos":{"description":"Apellidos registrados de la persona.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"total_designaciones":{"description":"Cantidad de designaciones registradas para la persona.","type":"number"},"primera_designacion":{"nullable":true,"anyOf":[{"description":"Primera designación registrada en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"ultima_designacion":{"nullable":true,"anyOf":[{"description":"Última fecha registrada de ejercicio o inicio, en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"homonimos":{"description":"Cantidad de otras personas con el mismo nombre y apellidos normalizados.","type":"number"}},"additionalProperties":false}},"pagination":{"type":"object","required":["limit","offset","count","total","has_more"],"properties":{"limit":{"type":"number"},"offset":{"type":"number"},"count":{"type":"number"},"total":{"description":"Total de personas que cumplen el filtro actual.","type":"number"},"has_more":{"description":"Indica si existe una página siguiente con los parámetros actuales.","type":"boolean"}}}},"required":["data","pagination"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1Personas","summary":"Listado canónico de personas registradas","description":"Retorna personas con designaciones registradas, con búsqueda textual opcional y paginación básica.","tags":["Personas"]}},"/v1/personas/{id}/trayectoria":{"get":{"parameters":[{"description":"ID numérico positivo de la persona.","schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true}],"responses":{"200":{"items":{"type":"object","required":["cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"cargo":{"description":"Cargo ocupado, usando denominación histórica cuando está disponible.","type":"string"},"ministerio":{"description":"Ministerio asociado al cargo en la fecha de designación.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"description":"Gobierno asociado a la fecha de inicio de la designación.","type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"cargo":{"description":"Cargo ocupado, usando denominación histórica cuando está disponible.","type":"string"},"ministerio":{"description":"Ministerio asociado al cargo en la fecha de designación.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"description":"Gobierno asociado a la fecha de inicio de la designación.","type":"string"}}}}},"multipart/form-data":{"schema":{"type":"array","items":{"type":"object","required":["cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"cargo":{"description":"Cargo ocupado, usando denominación histórica cuando está disponible.","type":"string"},"ministerio":{"description":"Ministerio asociado al cargo en la fecha de designación.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"description":"Gobierno asociado a la fecha de inicio de la designación.","type":"string"}}}}},"text/plain":{"schema":{"type":"array","items":{"type":"object","required":["cargo","ministerio","fecha_inicio","fecha_termino","genero","partido_politico","gobierno"],"properties":{"cargo":{"description":"Cargo ocupado, usando denominación histórica cuando está disponible.","type":"string"},"ministerio":{"description":"Ministerio asociado al cargo en la fecha de designación.","type":"string"},"fecha_inicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fecha_termino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"partido_politico":{"nullable":true,"anyOf":[{"type":"object","required":["sigla","nombre"],"properties":{"sigla":{"description":"Sigla normalizada del partido o condición política.","type":"string"},"nombre":{"description":"Nombre normalizado del partido o condición política.","type":"string"}}},{"type":"null"}]},"gobierno":{"description":"Gobierno asociado a la fecha de inicio de la designación.","type":"string"}}}}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1PersonasByIdTrayectoria","summary":"Trayectoria canónica de una persona","description":"Retorna las designaciones de una persona, con cargo, ministerio, gobierno y fechas históricas.","tags":["Personas"]}},"/v1/personas/{id}":{"get":{"parameters":[{"description":"ID numérico positivo de la persona.","schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"description":"Identificador numérico estable de la persona.","type":"number"},"nombres":{"description":"Nombres registrados de la persona.","type":"string"},"apellidos":{"description":"Apellidos registrados de la persona.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"total_designaciones":{"description":"Cantidad de designaciones registradas para la persona.","type":"number"},"primera_designacion":{"nullable":true,"anyOf":[{"description":"Primera designación registrada en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"ultima_designacion":{"nullable":true,"anyOf":[{"description":"Última fecha registrada de ejercicio o inicio, en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"homonimos":{"description":"Cantidad de otras personas con el mismo nombre y apellidos normalizados.","type":"number"}},"required":["id","nombres","apellidos","genero","total_designaciones","primera_designacion","ultima_designacion","homonimos"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"id":{"description":"Identificador numérico estable de la persona.","type":"number"},"nombres":{"description":"Nombres registrados de la persona.","type":"string"},"apellidos":{"description":"Apellidos registrados de la persona.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"total_designaciones":{"description":"Cantidad de designaciones registradas para la persona.","type":"number"},"primera_designacion":{"nullable":true,"anyOf":[{"description":"Primera designación registrada en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"ultima_designacion":{"nullable":true,"anyOf":[{"description":"Última fecha registrada de ejercicio o inicio, en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"homonimos":{"description":"Cantidad de otras personas con el mismo nombre y apellidos normalizados.","type":"number"}},"required":["id","nombres","apellidos","genero","total_designaciones","primera_designacion","ultima_designacion","homonimos"]}},"text/plain":{"schema":{"type":"object","properties":{"id":{"description":"Identificador numérico estable de la persona.","type":"number"},"nombres":{"description":"Nombres registrados de la persona.","type":"string"},"apellidos":{"description":"Apellidos registrados de la persona.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en fuentes oficiales.","type":"string"},{"type":"null"}]},"total_designaciones":{"description":"Cantidad de designaciones registradas para la persona.","type":"number"},"primera_designacion":{"nullable":true,"anyOf":[{"description":"Primera designación registrada en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"ultima_designacion":{"nullable":true,"anyOf":[{"description":"Última fecha registrada de ejercicio o inicio, en formato ISO 8601.","format":"date-time","type":"string"},{"type":"null"}]},"homonimos":{"description":"Cantidad de otras personas con el mismo nombre y apellidos normalizados.","type":"number"}},"required":["id","nombres","apellidos","genero","total_designaciones","primera_designacion","ultima_designacion","homonimos"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1PersonasById","summary":"Ficha canónica de una persona","description":"Retorna la ficha resumida de una persona con conteo y rango de designaciones registradas.","tags":["Personas"]}},"/v1/search":{"get":{"parameters":[{"description":"Término de búsqueda. Busca en nombres, cargos, ministerios y siglas.","schema":{"type":"string","minLength":1},"in":"query","name":"q","required":true},{"description":"Cantidad máxima de resultados.","schema":{"default":20,"minimum":1,"maximum":100,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"description":"Cantidad máxima de resultados.","default":20,"minimum":1,"maximum":100,"type":"number"}]},"in":"query","name":"limit","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["type","id","label","subtitle","url"],"properties":{"type":{"description":"Tipo de resultado.","anyOf":[{"const":"ministerio","type":"string"},{"const":"persona","type":"string"},{"const":"autoridad","type":"string"},{"const":"gobierno","type":"string"}]},"id":{"description":"Identificador del recurso.","type":"number"},"label":{"description":"Nombre o etiqueta principal del resultado.","type":"string"},"subtitle":{"nullable":true,"anyOf":[{"description":"Contexto adicional (sigla, cargo, ministerio, presidente).","type":"string"},{"type":"null"}]},"url":{"description":"Ruta relativa al recurso en el frontend.","type":"string"}}}},"query":{"description":"Consulta original.","type":"string"},"count":{"description":"Cantidad de resultados devueltos.","type":"number"}},"required":["data","query","count"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["type","id","label","subtitle","url"],"properties":{"type":{"description":"Tipo de resultado.","anyOf":[{"const":"ministerio","type":"string"},{"const":"persona","type":"string"},{"const":"autoridad","type":"string"},{"const":"gobierno","type":"string"}]},"id":{"description":"Identificador del recurso.","type":"number"},"label":{"description":"Nombre o etiqueta principal del resultado.","type":"string"},"subtitle":{"nullable":true,"anyOf":[{"description":"Contexto adicional (sigla, cargo, ministerio, presidente).","type":"string"},{"type":"null"}]},"url":{"description":"Ruta relativa al recurso en el frontend.","type":"string"}}}},"query":{"description":"Consulta original.","type":"string"},"count":{"description":"Cantidad de resultados devueltos.","type":"number"}},"required":["data","query","count"]}},"text/plain":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["type","id","label","subtitle","url"],"properties":{"type":{"description":"Tipo de resultado.","anyOf":[{"const":"ministerio","type":"string"},{"const":"persona","type":"string"},{"const":"autoridad","type":"string"},{"const":"gobierno","type":"string"}]},"id":{"description":"Identificador del recurso.","type":"number"},"label":{"description":"Nombre o etiqueta principal del resultado.","type":"string"},"subtitle":{"nullable":true,"anyOf":[{"description":"Contexto adicional (sigla, cargo, ministerio, presidente).","type":"string"},{"type":"null"}]},"url":{"description":"Ruta relativa al recurso en el frontend.","type":"string"}}}},"query":{"description":"Consulta original.","type":"string"},"count":{"description":"Cantidad de resultados devueltos.","type":"number"}},"required":["data","query","count"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"429":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"code":{"description":"Código estable de error.","type":"string"},"message":{"description":"Mensaje legible del error.","type":"string"},"details":{"type":"object","patternProperties":{"^(.*)$":{}}}},"required":["code","message"]}}}}},"operationId":"getV1Search","summary":"Búsqueda global","description":"Busca en ministerios, personas y autoridades simultáneamente. Retorna resultados ordenados por relevancia con URL relativa para navegación directa.","tags":["Búsqueda"]}}},"components":{"schemas":{}}}