{"swagger":"2.0","info":{"description":"Kamer van volksvertegenwoordigers/Chambre des représentants","version":"v0","title":"Parliamentary Open Data Collections"},"basePath":"/v0","tags":[{"name":"ACTR","description":"Political actors (members of parliament, members of government, etc.)"},{"name":"ORGN","description":"Political organs (commissions, plenary meeting, bureau, government, etc.)"},{"name":"QRVA","description":"Written questions"},{"name":"INQO","description":"Interpellations and oral questions (parliamentary term 54)"},{"name":"orgn"}],"paths":{"/actr":{"get":{"tags":["ACTR"],"summary":"","description":"Returns a result set with ACTR objects that satisfy a number of filters","operationId":"actrSearch","produces":["application/xml","application/json"],"parameters":[{"name":"start","in":"query","description":"The offset position in the result set to start reading from. If omitted, a value of 0 is assumed","required":false,"type":"integer","default":0,"format":"int32"},{"name":"name","in":"query","description":"a string that matches full name or one or more terms in the last name exactly","required":false,"type":"string"},{"name":"fName","in":"query","description":"a string that matches first name or one or more terms in the first name exactly","required":false,"type":"string"},{"name":"languageCode","in":"query","description":"Languagecode: N (Dutch) or F (French)","required":false,"type":"string"}],"responses":{"200":{"description":"Successful response"},"404":{"description":"The index was not found"}}}},"/actr/{gaab-id}":{"get":{"tags":["ACTR"],"summary":"","description":"Retrieves the public data available for a political actor related to the Belgian House of Representatives having an internal identifier {gaab-id} ","operationId":"getById","produces":["application/xml","application/json"],"parameters":[{"name":"gaab-id","in":"path","description":"internal identifier of a political actor","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Successful response"},"204":{"description":"The id was not found"}}}},"/inqo/archive":{"get":{"tags":["INQO"],"summary":"","description":"Return a zip-file with all public oral questions for the given parlimanetery term parliamentary term {leg}. The zip contains one xml-file (<sdocname>.xml) and one json-file (<sdocname>.json) per oral question or interpellation.  The data for parliamentary term 55 is not yet available.","operationId":"archive","produces":["application/octet-stream"],"parameters":[{"name":"leg","in":"query","description":"integer indicating the parliamentary term","required":false,"type":"integer","default":54,"format":"int32"}],"responses":{"200":{"description":"Successful response"},"204":{"description":"The file was not found"}}}},"/orgn":{"get":{"tags":["ORGN"],"summary":"","description":"Returns a paginated result set containing political organs(plenary meeting, committees, political fractions, etc.) that satisfy a number of filters","operationId":"orgnSearch","produces":["application/xml","application/json","text/plain"],"parameters":[{"name":"start","in":"query","description":"The offset position in the result set to start reading from. If omitted, a value of 0 is assumed","required":false,"type":"integer","default":0,"format":"int32"},{"name":"rows","in":"query","description":"The page-size of the paginated resultset.  If omitted, a value of 10 is assumed.  This value may not exceed 200.","required":false,"type":"integer","default":10,"format":"int32"},{"name":"short_NL","in":"query","description":"a string that matches one or more terms in the short name (NL) exactly","required":false,"type":"string"},{"name":"short_FR","in":"query","description":"a string that matches one or more terms in the short name (FR) exactly","required":false,"type":"string"},{"name":"description_NL","in":"query","description":"a string that matches one or more terms in the description (NL) exactly","required":false,"type":"string"},{"name":"description_FR","in":"query","description":"a string that matches one or more terms in the description (NL) exactly","required":false,"type":"string"},{"name":"code","in":"query","description":"a string that matches the code.  A trailing wildcard (\"*\") is allowed","required":false,"type":"string"}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad request"},"500":{"description":"Internal server error"}}}},"/orgn/{orgn-id}":{"get":{"tags":["ORGN"],"summary":"","description":"Retrieves the detail of a political organ with id={orgn-id}","operationId":"orgnOrgnIdGet","produces":["application/xml","application/json"],"parameters":[{"name":"orgn-id","in":"path","description":"internal identifier of the political organ","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Succesfull response"},"500":{"description":"Internal server error"},"204":{"description":"The organ with the given id was not found"}}}},"/qrva":{"get":{"tags":["QRVA"],"summary":"","description":"Returns a paginated resultset with Written Questions that satisfy a number of filters","operationId":"search","produces":["application/xml","application/json"],"parameters":[{"name":"start","in":"query","description":"the offset position in the result set to start reading from. If omitted, a value of 0 is assumed.","required":false,"type":"integer","default":0,"format":"int32"},{"name":"leg","in":"query","description":"integer indicating the parliamentary term. If omitted, a value of 55 (the current parliamentery term) is assumed","required":false,"type":"integer","default":55,"format":"int32"},{"name":"aut","in":"query","description":"(part of) the name of the deputee who has submitted a written question","required":false,"type":"string"},{"name":"titn","in":"query","description":"a string that must appear in the Dutch title","required":false,"type":"string"},{"name":"titf","in":"query","description":"a string that must appear in the French title","required":false,"type":"string"},{"name":"thesan","in":"query","description":"a string that must appear in list of Dutch keywords","required":false,"type":"string"},{"name":"thesaf","in":"query","description":"a string that must appear in list of Dutch keywords","required":false,"type":"string"},{"name":"search","in":"query","description":"a string that must appear somewhere in the complete document (Dutch or French)","required":false,"type":"string"}],"responses":{"200":{"description":"Successful response"},"404":{"description":"The index was not found"}}}},"/qrva/archive":{"get":{"tags":["QRVA"],"summary":"","description":"Return a zip-file with all public written questions for the given parlimanetery term parliamentary term {leg}. The zip contains one file <sdocname>.xml/<sdocname>.json per written question. ","operationId":"archive","produces":["application/octet-stream"],"parameters":[{"name":"leg","in":"query","description":"integer indicating the parliamentary term","required":false,"type":"integer","default":55,"format":"int32"}],"responses":{"200":{"description":"Successful response"},"204":{"description":"The file was not found"}}}},"/qrva/{qrva-id}":{"get":{"tags":["QRVA"],"summary":"","description":"Retrieves a particular Written Question with identifier {qrva-id} in the parliamentary term {leg} ","operationId":"getById","produces":["application/xml","application/json"],"parameters":[{"name":"qrva-id","in":"path","description":"identifier of a written question","required":true,"type":"string"}],"responses":{"200":{"description":"Successful response"},"204":{"description":"The document was not found"}}}}},"definitions":{"ResultSetTypologyEntrySummary":{"type":"object","properties":{"items":{"$ref":"#/definitions/ResultSetItemsTypologyEntrySummary"}},"xml":{"name":"result"}},"ResultSetItemsTypologyEntrySummary":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/definitions/TypologyEntrySummary"}}}},"ResultSetItemsQrvaDocSummary":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/definitions/QrvaDocSummary"}}}},"ResultSetQrvaDocSummary":{"type":"object","properties":{"items":{"$ref":"#/definitions/ResultSetItemsQrvaDocSummary"}},"xml":{"name":"result"}},"TypologyEntrySummary":{"type":"object","properties":{"id":{"type":"integer","format":"int32"},"selfLink":{"xml":{"name":"link"},"$ref":"#/definitions/Link"},"code":{"type":"string"},"fullName_FR":{"type":"string"},"fullName_NL":{"type":"string"}},"xml":{"name":"ouSummary"}},"ResultSetPersonSummary":{"type":"object","properties":{"items":{"$ref":"#/definitions/ResultSetItemsPersonSummary"}},"xml":{"name":"result"}},"ResultSetItemsPersonSummary":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/definitions/PersonSummary"}}}},"QrvaDocSummary":{"type":"object","properties":{"aut":{"type":"string"},"mainthesan":{"type":"string"},"deptn":{"type":"string"},"selfLink":{"xml":{"name":"link"},"$ref":"#/definitions/Link"},"statusq":{"type":"string"},"titn":{"type":"string"},"titf":{"type":"string"},"sdocname":{"type":"string"},"mainthesaf":{"type":"string"},"deptf":{"type":"string"}},"xml":{"name":"QRVADOCSUMMARY"}},"PersonSummary":{"type":"object","properties":{"name":{"type":"string"},"selfLink":{"xml":{"name":"link"},"$ref":"#/definitions/Link"},"getfName":{"type":"string"},"gaabId":{"type":"integer","format":"int32"}},"xml":{"name":"personSummary"}},"Link":{"type":"object","properties":{"uri":{"type":"string","format":"uri","xml":{"name":"href","attribute":true}},"rel":{"type":"string","xml":{"attribute":true}}}}}}