{"openapi":"3.0.3","info":{"title":"kdo-vodi.si \u2014 Public Office Registry API","version":"1.0.0","description":"Kdo zaseda katero javno funkcijo v Sloveniji \u2014 osebe, organizacije in funkcije, z virom za vsak podatek.\n\nOdprt, brezpla\u010den, brez prijave. Vsi odgovori so JSON. Seznami so ostranjeni (Laravel pagination)."},"servers":[{"url":"https:\/\/kdo-vodi.si\/api\/v1","description":"v1"}],"tags":[{"name":"Organizacije"},{"name":"Nosilci funkcij"},{"name":"Osebe"},{"name":"Viri"}],"paths":{"\/organizations":{"get":{"tags":["Organizacije"],"summary":"Seznam organizacij","operationId":"listOrganizations","parameters":[{"name":"type","in":"query","description":"Filter po vrsti (root_type), npr. ministry, agency, municipality","required":false,"schema":{"type":"string"}},{"name":"parent","in":"query","description":"Filter po slugu nadrejene organizacije","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","description":"Iskanje po imenu","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"minimum":1,"maximum":200}},{"name":"page","in":"query","schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"OK","content":{"application\/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#\/components\/schemas\/Organization"}},"links":{"$ref":"#\/components\/schemas\/PaginationLinks"},"meta":{"$ref":"#\/components\/schemas\/PaginationMeta"}}}}}}}}},"\/organizations\/{slug}":{"get":{"tags":["Organizacije"],"summary":"Ena organizacija (z nadrejenim in podrejenimi organi)","operationId":"getOrganization","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application\/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#\/components\/schemas\/Organization"},"children":{"type":"array","items":{"$ref":"#\/components\/schemas\/OrgRef"}}}}}}},"404":{"description":"Ni najdeno"}}}},"\/office-holders":{"get":{"tags":["Nosilci funkcij"],"summary":"Seznam nosilcev funkcij","operationId":"listOfficeHolders","parameters":[{"name":"office","in":"query","description":"Filter po \u0161ifri funkcije, npr. mayor, mp, minister, director","required":false,"schema":{"type":"string"}},{"name":"organization","in":"query","description":"Filter po slugu organizacije","required":false,"schema":{"type":"string"}},{"name":"person","in":"query","description":"Filter po slugu osebe","required":false,"schema":{"type":"string"}},{"name":"current","in":"query","description":"Samo trenutni nosilci (privzeto true)","schema":{"type":"boolean","default":true}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"minimum":1,"maximum":200}},{"name":"page","in":"query","schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"OK","content":{"application\/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#\/components\/schemas\/OfficeHolder"}},"links":{"$ref":"#\/components\/schemas\/PaginationLinks"},"meta":{"$ref":"#\/components\/schemas\/PaginationMeta"}}}}}}}}},"\/people":{"get":{"tags":["Osebe"],"summary":"Iskanje oseb","operationId":"listPeople","parameters":[{"name":"q","in":"query","description":"Iskanje po imenu","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"minimum":1,"maximum":200}},{"name":"page","in":"query","schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"OK","content":{"application\/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#\/components\/schemas\/Person"}},"links":{"$ref":"#\/components\/schemas\/PaginationLinks"},"meta":{"$ref":"#\/components\/schemas\/PaginationMeta"}}}}}}}}},"\/people\/{slug}":{"get":{"tags":["Osebe"],"summary":"Ena oseba z zgodovino funkcij","operationId":"getPerson","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application\/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#\/components\/schemas\/Person"}}}}}},"404":{"description":"Ni najdeno"}}}},"\/sources":{"get":{"tags":["Viri"],"summary":"Seznam virov podatkov","operationId":"listSources","responses":{"200":{"description":"OK","content":{"application\/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#\/components\/schemas\/Source"}}}}}}}}}}},"components":{"schemas":{"OrgRef":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}}},"SourceRef":{"type":"object","properties":{"authority":{"type":"string"},"url":{"type":"string","format":"uri","description":"The exact page the fact was read from"}}},"Image":{"type":"object","nullable":true,"properties":{"url":{"type":"string","format":"uri"},"attribution":{"type":"string","nullable":true},"source":{"type":"string","format":"uri"},"hosted":{"type":"boolean"}}},"Organization":{"type":"object","properties":{"slug":{"type":"string","example":"vlada"},"name":{"type":"string","example":"Vlada Republike Slovenije"},"type":{"type":"string","example":"government"},"parent":{"nullable":true,"allOf":[{"$ref":"#\/components\/schemas\/OrgRef"}]},"website":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"leader":{"type":"object","nullable":true,"properties":{"name":{"type":"string"},"person_slug":{"type":"string"},"office":{"type":"string"},"office_code":{"type":"string"},"since":{"type":"string","format":"date","nullable":true}}},"image":{"allOf":[{"$ref":"#\/components\/schemas\/Image"}]},"sources":{"type":"array","items":{"$ref":"#\/components\/schemas\/SourceRef"},"description":"Exact source page(s) behind this organization"},"url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"}}},"OfficeHolder":{"type":"object","properties":{"person":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"}}},"office":{"type":"string","example":"\u017eupan"},"office_code":{"type":"string","example":"mayor"},"role_detail":{"type":"string","nullable":true,"description":"Specific scraped role, e.g. a state secretary portfolio","example":"dr\u017eavni sekretar, pristojen za gospodarstvo"},"organization":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"}}},"since":{"type":"string","format":"date","nullable":true},"since_precision":{"type":"string"},"until":{"type":"string","format":"date","nullable":true},"status":{"type":"string"},"current":{"type":"boolean"},"sources":{"type":"array","items":{"$ref":"#\/components\/schemas\/SourceRef"},"description":"Exact source page(s) this record was read from"}}},"Person":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"birth_year":{"type":"integer","nullable":true},"image":{"allOf":[{"$ref":"#\/components\/schemas\/Image"}]},"offices":{"type":"array","items":{"$ref":"#\/components\/schemas\/OfficeHolder"}},"url":{"type":"string"},"api_url":{"type":"string"}}},"Source":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"authority":{"type":"string"}}},"PaginationLinks":{"type":"object","properties":{"first":{"type":"string","nullable":true},"last":{"type":"string","nullable":true},"prev":{"type":"string","nullable":true},"next":{"type":"string","nullable":true}}},"PaginationMeta":{"type":"object","properties":{"current_page":{"type":"integer"},"last_page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"}}}}}}