{"openapi":"3.1.0","info":{"title":"Riksflödet API","version":"1","description":"Läsbart API över Sveriges riksdags öppna data: ledamöter, voteringar, anföranden och kalender. Varje svar har url (sidan på Riksflödet att citera), kalla och data. Max 60 anrop per minut och IP-adress.","license":{"name":"Riksdagens öppna data (data.riksdagen.se). Ange källan vid återgivning."}},"servers":[{"url":"https://riksflodet.se/api/v1"}],"paths":{"/sok":{"get":{"summary":"Fritextsök","operationId":"sok","parameters":[{"name":"q","in":"query","required":true,"description":"Sökfråga","schema":{"type":"string"}},{"name":"typ","in":"query","required":false,"description":"anforande (standard) eller dokument","schema":{"type":"string","enum":["anforande","dokument"]}},{"name":"n","in":"query","required":false,"description":"Antal träffar","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Träffar med url","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Svar"}}}},"400":{"description":"Felaktig parameter"},"404":{"description":"Hittades inte"},"429":{"description":"Mer än 60 anrop per minut; se Retry-After"}}}},"/personer":{"get":{"summary":"Sök sittande ledamöter och statsråd","operationId":"personer","parameters":[{"name":"namn","in":"query","required":false,"description":"Del av namnet","schema":{"type":"string"}},{"name":"parti","in":"query","required":false,"description":"Partikod, till exempel S","schema":{"type":"string"}},{"name":"n","in":"query","required":false,"description":"Antal","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Personer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Svar"}}}},"400":{"description":"Felaktig parameter"},"404":{"description":"Hittades inte"},"429":{"description":"Mer än 60 anrop per minut; se Retry-After"}}}},"/person/{id}":{"get":{"summary":"En person","operationId":"person","parameters":[{"name":"id","in":"path","required":true,"description":"intressent_id","schema":{"type":"string"}}],"responses":{"200":{"description":"Person med röststatistik","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Svar"}}}},"400":{"description":"Felaktig parameter"},"404":{"description":"Hittades inte"},"429":{"description":"Mer än 60 anrop per minut; se Retry-After"}}}},"/person/{id}/voteringar":{"get":{"summary":"Hur personen röstade","operationId":"personVoteringar","parameters":[{"name":"id","in":"path","required":true,"description":"intressent_id","schema":{"type":"string"}},{"name":"n","in":"query","required":false,"description":"Antal","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"fran","in":"query","required":false,"description":"Från och med datum","schema":{"type":"string","format":"date"}},{"name":"till","in":"query","required":false,"description":"Till och med datum","schema":{"type":"string","format":"date"}},{"name":"avvek","in":"query","required":false,"description":"1 = bara röster mot partilinjen","schema":{"type":"string","enum":["1"]}}],"responses":{"200":{"description":"Röster med partiets linje","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Svar"}}}},"400":{"description":"Felaktig parameter"},"404":{"description":"Hittades inte"},"429":{"description":"Mer än 60 anrop per minut; se Retry-After"}}}},"/person/{id}/anforanden":{"get":{"summary":"Personens senaste anföranden","operationId":"personAnforanden","parameters":[{"name":"id","in":"path","required":true,"description":"intressent_id","schema":{"type":"string"}},{"name":"n","in":"query","required":false,"description":"Antal","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Anföranden som ren text, kapade vid 2 000 tecken","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Svar"}}}},"400":{"description":"Felaktig parameter"},"404":{"description":"Hittades inte"},"429":{"description":"Mer än 60 anrop per minut; se Retry-After"}}}},"/votering/{id}":{"get":{"summary":"En votering","operationId":"votering","parameters":[{"name":"id","in":"path","required":true,"description":"votering_id","schema":{"type":"string"}},{"name":"roster","in":"query","required":false,"description":"1 = med varje ledamots röst","schema":{"type":"string","enum":["1"]}}],"responses":{"200":{"description":"Votering med partiernas linjer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Svar"}}}},"400":{"description":"Felaktig parameter"},"404":{"description":"Hittades inte"},"429":{"description":"Mer än 60 anrop per minut; se Retry-After"}}}},"/voteringar":{"get":{"summary":"Voteringar","operationId":"voteringar","parameters":[{"name":"fran","in":"query","required":false,"description":"Från och med datum","schema":{"type":"string","format":"date"}},{"name":"till","in":"query","required":false,"description":"Till och med datum","schema":{"type":"string","format":"date"}},{"name":"organ","in":"query","required":false,"description":"Utskottskod, till exempel FiU","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Ord i titeln","schema":{"type":"string"}},{"name":"n","in":"query","required":false,"description":"Antal","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Voteringar, nyast först","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Svar"}}}},"400":{"description":"Felaktig parameter"},"404":{"description":"Hittades inte"},"429":{"description":"Mer än 60 anrop per minut; se Retry-After"}}}},"/anforande/{id}":{"get":{"summary":"Ett anförande","operationId":"anforande","parameters":[{"name":"id","in":"path","required":true,"description":"<dok_id>-<nummer>, till exempel HD09157-1","schema":{"type":"string"}}],"responses":{"200":{"description":"Anförande, texten kapad vid 2 000 tecken","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Svar"}}}},"400":{"description":"Felaktig parameter"},"404":{"description":"Hittades inte"},"429":{"description":"Mer än 60 anrop per minut; se Retry-After"}}}},"/parti/{kod}/linje":{"get":{"summary":"Ett partis linje","operationId":"partiLinje","parameters":[{"name":"kod","in":"path","required":true,"description":"Partikod","schema":{"type":"string"}},{"name":"votering","in":"query","required":false,"description":"votering_id","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Ord i voteringens titel","schema":{"type":"string"}},{"name":"n","in":"query","required":false,"description":"Antal","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Partiets linje per votering","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Svar"}}}},"400":{"description":"Felaktig parameter"},"404":{"description":"Hittades inte"},"429":{"description":"Mer än 60 anrop per minut; se Retry-After"}}}},"/kalender":{"get":{"summary":"Kommande händelser","operationId":"kalender","parameters":[{"name":"dagar","in":"query","required":false,"description":"Antal dagar framåt","schema":{"type":"integer","minimum":1,"maximum":60,"default":14}}],"responses":{"200":{"description":"Händelser","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Svar"}}}},"400":{"description":"Felaktig parameter"},"404":{"description":"Hittades inte"},"429":{"description":"Mer än 60 anrop per minut; se Retry-After"}}}}},"components":{"schemas":{"Svar":{"type":"object","required":["url","kalla","data"],"properties":{"url":{"type":"string","format":"uri","description":"Adressen som anropades"},"kalla":{"type":"object","properties":{"namn":{"type":"string"},"ursprung":{"type":"string"},"uppdaterad":{"type":["string","null"]},"licens":{"type":"string"}}},"data":{}}}}}}