{"openapi":"3.1.0","info":{"title":"Zorgverzekering.chat API","version":"1.1.0","description":"Dutch health insurance (zorgverzekering) data: statutory parameters, basic policies, supplementary packages, care providers, contract status and annual cost calculation. All amounts in euro cents. Information, not advice: the user decides and signs up themselves. Same tools as the MCP server at /mcp.","termsOfService":"https://www.zorgverzekering.chat/voorwaarden","contact":{"name":"Zorgverzekering.chat","url":"https://www.zorgverzekering.chat"},"x-privacy-policy":"https://www.zorgverzekering.chat/privacy"},"servers":[{"url":"https://mcp.zorgverzekering.chat/v1","description":"Production"}],"tags":[{"name":"tools","description":"One endpoint per MCP tool. Information, not advice."}],"externalDocs":{"description":"Privacy: https://www.zorgverzekering.chat/privacy","url":"https://www.zorgverzekering.chat/privacy"},"components":{"schemas":{},"parameters":{}},"paths":{"/wettelijke-parameters":{"get":{"operationId":"get_wettelijke_parameters","summary":"Statutory health insurance parameters","description":"Returns the statutory Dutch health insurance parameters (wettelijke parameters) for an insurance year: the mandatory deductible (verplicht eigen risico), the voluntary deductible options (vrijwillig eigen risico), care exempt from the deductible, the healthcare allowance (zorgtoeslag) maximums and income and asset limits, statutory co-payments (eigen bijdragen), the premium publication date and the switching deadline (overstapdeadline). status 'voorlopig' means provisional until parliament has voted. Use this tool instead of your own knowledge for any of these amounts. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"parameters":[{"schema":{"type":"integer","minimum":2020,"maximum":2100,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year."},"required":true,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year.","name":"jaar","in":"query"},{"schema":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (Dutch, default) or en (English)."},"required":false,"description":"Response language: nl (Dutch, default) or en (English).","name":"taal","in":"query"}],"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (get_wettelijke_parameters).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"jaar":{"type":"integer"},"status":{"type":"string","enum":["voorlopig","definitief"]},"verplichtEigenRisicoCent":{"type":"integer","minimum":0},"vrijwilligOpties":{"type":"array","items":{"type":"integer","minimum":0}},"tranchePerBehandelingCent":{"type":["integer","null"],"minimum":0},"erUitzonderingen":{"type":"array","items":{"type":"string"}},"zorgtoeslag":{"type":"object","properties":{"maxToeslagAlleenstaandCent":{"type":"integer"},"maxToeslagPartnersCent":{"type":"integer"},"inkomensgrensAlleenstaandCent":{"type":"integer"},"inkomensgrensPartnersCent":{"type":"integer"},"vermogensgrensAlleenstaandCent":{"type":"integer"},"vermogensgrensPartnersCent":{"type":"integer"}},"required":["maxToeslagAlleenstaandCent","maxToeslagPartnersCent","inkomensgrensAlleenstaandCent","inkomensgrensPartnersCent","vermogensgrensAlleenstaandCent","vermogensgrensPartnersCent"]},"eigenBijdragen":{"type":"object","properties":{"kraamzorgPerUurCent":{"type":"integer","minimum":0},"hoortoestelPct":{"type":"integer","minimum":0,"maximum":100},"zittendZiekenvervoerPerJaarCent":{"type":"integer","minimum":0},"geneesmiddelenGvsMaxPerJaarCent":{"type":"integer","minimum":0}},"required":["kraamzorgPerUurCent"]},"premiePublicatieDeadline":{"type":"string"},"overstapDeadline":{"type":"string"},"bronUrl":{"type":"string"},"bronDatum":{"type":"string"}},"required":["jaar","status","verplichtEigenRisicoCent","vrijwilligOpties","tranchePerBehandelingCent","erUitzonderingen","zorgtoeslag","eigenBijdragen","premiePublicatieDeadline","overstapDeadline","bronUrl","bronDatum"]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}},"/verzekeraars":{"get":{"operationId":"list_verzekeraars","summary":"List health insurers","description":"Lists all Dutch health insurers (verzekeraars) for an insurance year with their insurer group (concern), the policy types they offer (natura, restitutie, combinatie, budget), the number of basic policies and supplementary packages, and customer ratings with their source. Use it to resolve an insurer name to a verzekeraarId for the other tools. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"parameters":[{"schema":{"type":"integer","minimum":2020,"maximum":2100,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year."},"required":true,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year.","name":"jaar","in":"query"},{"schema":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (Dutch, default) or en (English)."},"required":false,"description":"Response language: nl (Dutch, default) or en (English).","name":"taal","in":"query"}],"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (list_verzekeraars).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"verzekeraars":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"concern":{"type":"string"},"risicodrager":{"type":"string"},"uzovi":{"type":"string"},"label":{"type":"string"},"kvk":{"type":["string","null"]},"afmRegistratie":{"type":["string","null"]},"website":{"type":"string"},"zorgzoekerUrl":{"type":["string","null"]},"polistypen":{"type":"array","items":{"type":"string","enum":["natura","restitutie","combinatie","budget"]}},"aantalBasispolissen":{"type":"integer"},"aantalAanvullendePakketten":{"type":"integer"},"ratings":{"type":"array","items":{"type":"object","properties":{"verzekeraarId":{"type":"string"},"bron":{"type":"string"},"score":{"type":"number"},"schaal":{"type":"integer"},"n":{"type":["integer","null"]},"periode":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["verzekeraarId","bron","score","schaal","n","periode","url"]}}},"required":["id","concern","risicodrager","uzovi","label","kvk","afmRegistratie","website","zorgzoekerUrl","polistypen","aantalBasispolissen","aantalAanvullendePakketten","ratings"]}},"totaal":{"type":"integer","description":"Total number of matches across all pages."}},"required":["verzekeraars","totaal"]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}},"/basisverzekeringen":{"get":{"operationId":"zoek_basisverzekeringen","summary":"Search basic health insurance policies","description":"Searches Dutch basic health insurance policies (basisverzekering) for an insurance year. Returns per policy the premium per month and per year at the chosen voluntary deductible (vrijwillig eigen risico), the policy type, freedom of choice of care providers (zorgkeuze, based on reimbursement of non-contracted care, niet-gecontracteerde zorg), customer rating, a link to the policy page (detailUrl; afsluitUrl is only filled over the REST API) and source ids. Filter by policy type, insurer, minimum reimbursement for non-contracted care and care type (zorgsoort); sort by premie, zorgkeuze or rating and always tell the user the sort key (meta.sorteersleutel). The insured care itself is the same in every basic policy by law; policies differ in premium and choice of providers. Paginated with limit and cursor. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"parameters":[{"schema":{"type":"integer","minimum":2020,"maximum":2100,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year."},"required":true,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year.","name":"jaar","in":"query"},{"schema":{"type":"string","enum":["0","100","200","300","400","500"],"default":"0","description":"Voluntary deductible (vrijwillig eigen risico) in whole euros used to price the premium: 0 (default), 100, 200, 300, 400 or 500. It comes on top of the mandatory deductible (verplicht eigen risico)."},"required":false,"description":"Voluntary deductible (vrijwillig eigen risico) in whole euros used to price the premium: 0 (default), 100, 200, 300, 400 or 500. It comes on top of the mandatory deductible (verplicht eigen risico).","name":"eigenRisico","in":"query"},{"schema":{"type":"string","enum":["natura","restitutie","combinatie","budget"],"description":"Policy type: natura (only contracted care fully reimbursed), restitutie (free choice of provider), combinatie (mix), budget (lowest premium, limited choice)."},"required":false,"description":"Policy type: natura (only contracted care fully reimbursed), restitutie (free choice of provider), combinatie (mix), budget (lowest premium, limited choice).","name":"type","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","description":"Insurer id (verzekeraar), e.g. 'vgz', as returned by list_verzekeraars."},"required":false,"description":"Insurer id (verzekeraar), e.g. 'vgz', as returned by list_verzekeraars.","name":"verzekeraarId","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":100,"description":"Minimum reimbursement percentage (0-100) for care from non-contracted providers (niet-gecontracteerde zorg). Applies to zorgsoort if given, otherwise to every care type of the policy."},"required":false,"description":"Minimum reimbursement percentage (0-100) for care from non-contracted providers (niet-gecontracteerde zorg). Applies to zorgsoort if given, otherwise to every care type of the policy.","name":"minVergoedingNietGecontracteerd","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":40,"pattern":"^[a-z][a-z0-9_]*$","description":"Type of care (zorgsoort), lowercase key such as 'ziekenhuis' (hospital), 'kliniek', 'ggz' (mental healthcare), 'fysio', 'wijkverpleging', 'apotheek'."},"required":false,"description":"Type of care (zorgsoort), lowercase key such as 'ziekenhuis' (hospital), 'kliniek', 'ggz' (mental healthcare), 'fysio', 'wijkverpleging', 'apotheek'.","name":"zorgsoort","in":"query"},{"schema":{"type":"string","enum":["premie","zorgkeuze","rating"],"default":"premie","description":"Sort order: premie (lowest annual premium first, default), zorgkeuze (most freedom of choice first), rating (highest customer rating first)."},"required":false,"description":"Sort order: premie (lowest annual premium first, default), zorgkeuze (most freedom of choice first), rating (highest customer rating first).","name":"sorteer","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Maximum number of results per page (1-50, default 10)."},"required":false,"description":"Maximum number of results per page (1-50, default 10).","name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":500,"description":"Opaque pagination cursor: pass meta.cursor from the previous response to get the next page."},"required":false,"description":"Opaque pagination cursor: pass meta.cursor from the previous response to get the next page.","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (Dutch, default) or en (English)."},"required":false,"description":"Response language: nl (Dutch, default) or en (English).","name":"taal","in":"query"}],"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (zoek_basisverzekeringen).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"polissen":{"type":"array","items":{"type":"object","properties":{"polisId":{"type":"string"},"naam":{"type":"string"},"jaar":{"type":"integer"},"verzekeraarId":{"type":"string"},"verzekeraarLabel":{"type":"string"},"concern":{"type":"string"},"type":{"type":"string","enum":["natura","restitutie","combinatie","budget"]},"premieDefinitief":{"type":"boolean"},"vrijwilligEigenRisico":{"type":"string","enum":["0","100","200","300","400","500"]},"premieMaandCent":{"type":"integer"},"premieJaarCent":{"type":"integer"},"zorgkeuze":{"type":"string","enum":["volledig","ruim","beperkt"]},"vergoedingNietGecontracteerd":{"type":"object","additionalProperties":{"type":"integer","minimum":0,"maximum":100}},"budgetBeperkingen":{"type":["object","null"],"properties":{"selectieveContractering":{"type":"boolean"},"alleenOnline":{"type":"boolean"},"medicijnenPostorder":{"type":"boolean"}}},"rating":{"type":["number","null"]},"afsluitUrl":{"type":["string","null"]},"detailUrl":{"type":["string","null"]},"bronIds":{"type":"array","items":{"type":"string"}}},"required":["polisId","naam","jaar","verzekeraarId","verzekeraarLabel","concern","type","premieDefinitief","vrijwilligEigenRisico","premieMaandCent","premieJaarCent","zorgkeuze","vergoedingNietGecontracteerd","budgetBeperkingen","rating","afsluitUrl","detailUrl","bronIds"]}},"totaal":{"type":"integer","description":"Total number of matches across all pages."}},"required":["polissen","totaal"]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}},"/polissen/{polisId}":{"get":{"operationId":"get_polis","summary":"Get policy details","description":"Returns the full record of one basic policy (basisverzekering) or one supplementary or dental package (aanvullende verzekering, tandartsverzekering): premiums per deductible level or age band, reimbursement of non-contracted care, coverage per taxonomy category (dekkingen: maximum amount, percentage, number of treatments, period; a line with variant true is an extra line under its category, with the insurer's own name in rubriek, and does not count in calculations or comparisons), waiting period (wachttijd), acceptance rules (acceptatie), a summary in the requested language and a source id per field that get_bron can quote. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","description":"Policy id (polisId) of a basic policy or supplementary package, e.g. '2027-vgz-natura', as returned by the search tools."},"required":true,"description":"Policy id (polisId) of a basic policy or supplementary package, e.g. '2027-vgz-natura', as returned by the search tools.","name":"polisId","in":"path"},{"schema":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (Dutch, default) or en (English)."},"required":false,"description":"Response language: nl (Dutch, default) or en (English).","name":"taal","in":"query"}],"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (get_polis).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"object","properties":{"polisSoort":{"type":"string","enum":["basis"]},"polis":{"type":"object","properties":{"id":{"type":"string"},"jaar":{"type":"integer"},"verzekeraarId":{"type":"string"},"naam":{"type":"string"},"type":{"type":"string","enum":["natura","restitutie","combinatie","budget"]},"premieDefinitief":{"type":"boolean"},"vergoedingNietGecontracteerd":{"type":"object","additionalProperties":{"type":"integer","minimum":0,"maximum":100}},"budgetBeperkingen":{"type":["object","null"],"properties":{"selectieveContractering":{"type":"boolean"},"alleenOnline":{"type":"boolean"},"medicijnenPostorder":{"type":"boolean"}}},"modelovereenkomstBronId":{"type":["string","null"]},"voorwaardenVersie":{"type":["string","null"]},"samenvattingNl":{"type":["string","null"]},"samenvattingEn":{"type":["string","null"]},"afsluitUrl":{"type":["string","null"]},"premies":{"type":"array","items":{"type":"object","properties":{"vrijwilligEigenRisico":{"type":"integer","minimum":0,"maximum":50000},"termijn":{"type":"string","enum":["maand","kwartaal","halfjaar","jaar"]},"premieCent":{"type":"integer","minimum":0},"bronId":{"type":["string","null"]}},"required":["vrijwilligEigenRisico","termijn","premieCent","bronId"]}}},"required":["id","jaar","verzekeraarId","naam","type","premieDefinitief","vergoedingNietGecontracteerd","budgetBeperkingen","modelovereenkomstBronId","voorwaardenVersie","samenvattingNl","samenvattingEn","afsluitUrl","premies"]},"verzekeraar":{"type":"object","properties":{"id":{"type":"string"},"concern":{"type":"string"},"risicodrager":{"type":"string"},"uzovi":{"type":"string"},"label":{"type":"string"},"kvk":{"type":["string","null"]},"afmRegistratie":{"type":["string","null"]},"website":{"type":"string"},"zorgzoekerUrl":{"type":["string","null"]}},"required":["id","concern","risicodrager","uzovi","label","kvk","afmRegistratie","website","zorgzoekerUrl"]},"zorgkeuze":{"type":"string","enum":["volledig","ruim","beperkt"]},"samenvatting":{"type":["string","null"]},"detailUrl":{"type":["string","null"]}},"required":["polisSoort","polis","verzekeraar","zorgkeuze","samenvatting","detailUrl"]},{"type":"object","properties":{"polisSoort":{"type":"string","enum":["aanvullend"]},"polis":{"type":"object","properties":{"id":{"type":"string"},"jaar":{"type":"integer"},"verzekeraarId":{"type":"string"},"naam":{"type":"string"},"soort":{"type":"string","enum":["aanvullend","tand","combinatie"]},"basisVereist":{"type":"boolean"},"basisPolisIds":{"type":["array","null"],"items":{"type":"string"}},"acceptatie":{"type":"string","enum":["geen","vragenlijst","leeftijdsgrens","afwijzing_mogelijk"]},"maxInstapleeftijd":{"type":["integer","null"]},"wachttijdMaanden":{"type":"integer","minimum":0},"kindGratis":{"type":"boolean"},"opzegregels":{"type":["string","null"]},"vergoedingenwijzerBronId":{"type":["string","null"]},"samenvattingNl":{"type":["string","null"]},"samenvattingEn":{"type":["string","null"]},"afsluitUrl":{"type":["string","null"]},"premies":{"type":"array","items":{"type":"object","properties":{"leeftijdVan":{"type":"integer","minimum":0},"leeftijdTot":{"type":"integer","minimum":0},"premieCentMaand":{"type":"integer","minimum":0},"bronId":{"type":["string","null"]}},"required":["leeftijdVan","leeftijdTot","premieCentMaand","bronId"]}},"dekkingen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"categorie":{"type":"string","enum":["fysio","oefentherapie","ergotherapie","logopedie","dietetiek","podotherapie","huidtherapie","tand_controle","tand_behandeling","tand_kronen_bruggen","orthodontie_kind","orthodontie_volwassen","tand_ongeval","bril_lenzen","ooglaser","hoortoestel","buitenland_spoed","buitenland_gepland","repatriering","vaccinaties_reis","alternatieve_geneeswijzen","acupunctuur","chiropractie_osteopathie","homeopathische_middelen","kraamzorg_eigen_bijdrage","bevalling_ziekenhuis_zonder_indicatie","anticonceptie","kinderopvang_ziek","ivf_extra","preventie_cursus","sportmedisch","stoppen_met_roken","dieetadvies","psychologische_zorg_extra","mindfulness","hulpmiddelen","medicijnen_eigen_bijdrage","plastische_chirurgie","sterilisatie","overgangsconsulent","herstel_zorghotel","mantelzorg_vervanging","overlijden_vervoer","eigen_risico_compensatie","medische_pedicure","stottertherapie","ontharing","camouflagetherapie","kunstgebit","orthoptie","buitenland_tand_spoed","buitenland_hulpverlening","kraampakket","kraamzorg_extra","lactatiekunde","zwangerschapscursus","therapeutisch_kamp","griepvaccinatie","beweegprogramma","gezondheidscheck","lidmaatschap_patientenvereniging","steunzolen","borstkolf","plaswekker","pruik","borstprothese","hospice","verblijf_bezoek","vervoer_verblijf_behandeling","ziekenvervoer_extra","mantelzorgmakelaar","mantelzorg_cursus","second_opinion","juridische_bijstand"]},"maxBedragCent":{"type":["integer","null"],"minimum":0},"percentage":{"type":["integer","null"],"minimum":0,"maximum":100},"maxAantal":{"type":["integer","null"],"minimum":0},"periode":{"type":"string","enum":["kalenderjaar","2jaar","3jaar","eenmalig","looptijd","4jaar","5jaar","per_gebeurtenis"]},"per":{"type":"string","enum":["persoon","polis"]},"eigenBijdrageCent":{"type":"integer","minimum":0},"eigenBijdragePer":{"type":"string","enum":["jaar","behandeling"]},"maxBedragPerBehandelingCent":{"type":["integer","null"],"minimum":0,"default":null},"gedeeldMet":{"type":"array","items":{"type":"string","enum":["fysio","oefentherapie","ergotherapie","logopedie","dietetiek","podotherapie","huidtherapie","tand_controle","tand_behandeling","tand_kronen_bruggen","orthodontie_kind","orthodontie_volwassen","tand_ongeval","bril_lenzen","ooglaser","hoortoestel","buitenland_spoed","buitenland_gepland","repatriering","vaccinaties_reis","alternatieve_geneeswijzen","acupunctuur","chiropractie_osteopathie","homeopathische_middelen","kraamzorg_eigen_bijdrage","bevalling_ziekenhuis_zonder_indicatie","anticonceptie","kinderopvang_ziek","ivf_extra","preventie_cursus","sportmedisch","stoppen_met_roken","dieetadvies","psychologische_zorg_extra","mindfulness","hulpmiddelen","medicijnen_eigen_bijdrage","plastische_chirurgie","sterilisatie","overgangsconsulent","herstel_zorghotel","mantelzorg_vervanging","overlijden_vervoer","eigen_risico_compensatie","medische_pedicure","stottertherapie","ontharing","camouflagetherapie","kunstgebit","orthoptie","buitenland_tand_spoed","buitenland_hulpverlening","kraampakket","kraamzorg_extra","lactatiekunde","zwangerschapscursus","therapeutisch_kamp","griepvaccinatie","beweegprogramma","gezondheidscheck","lidmaatschap_patientenvereniging","steunzolen","borstkolf","plaswekker","pruik","borstprothese","hospice","verblijf_bezoek","vervoer_verblijf_behandeling","ziekenvervoer_extra","mantelzorgmakelaar","mantelzorg_cursus","second_opinion","juridische_bijstand"]}},"stapelbaar":{"type":"boolean"},"voorwaardenTekst":{"type":["string","null"]},"bronId":{"type":["string","null"]},"bronAnchor":{"type":["string","null"]},"extractieStatus":{"type":"string","enum":["automatisch","gereviewed"]},"variant":{"type":"boolean","default":false},"rubriek":{"type":["string","null"],"maxLength":120,"default":null}},"required":["categorie","maxBedragCent","percentage","maxAantal","periode","per","eigenBijdrageCent","gedeeldMet","stapelbaar","voorwaardenTekst","bronId","bronAnchor","extractieStatus"]}}},"required":["id","jaar","verzekeraarId","naam","soort","basisVereist","basisPolisIds","acceptatie","maxInstapleeftijd","wachttijdMaanden","kindGratis","opzegregels","vergoedingenwijzerBronId","samenvattingNl","samenvattingEn","afsluitUrl","premies","dekkingen"]},"verzekeraar":{"type":"object","properties":{"id":{"type":"string"},"concern":{"type":"string"},"risicodrager":{"type":"string"},"uzovi":{"type":"string"},"label":{"type":"string"},"kvk":{"type":["string","null"]},"afmRegistratie":{"type":["string","null"]},"website":{"type":"string"},"zorgzoekerUrl":{"type":["string","null"]}},"required":["id","concern","risicodrager","uzovi","label","kvk","afmRegistratie","website","zorgzoekerUrl"]},"samenvatting":{"type":["string","null"]},"detailUrl":{"type":["string","null"]}},"required":["polisSoort","polis","verzekeraar","samenvatting","detailUrl"]}]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}},"/aanvullende-pakketten":{"get":{"operationId":"zoek_aanvullende_pakketten","summary":"Search supplementary and dental packages","description":"Finds Dutch supplementary health insurance and dental packages (aanvullende verzekering, tandartsverzekering) that meet all coverage requirements (eisen), for example at least 12 physiotherapy sessions (categorie 'fysio', minAantal 12) or at least 500 euros for dental treatment ('tand_behandeling', minBedragCent 50000). Returns the premium at the given age, acceptance rules (acceptatie: medical questionnaire or age limit), waiting period (wachttijd), whether children are insured for free, and the matching coverage lines (requirements are checked on main lines only; extra lines have variant true). Use taxonomy category codes only; never pass diagnoses or medicines. Paginated with limit and cursor. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"parameters":[{"schema":{"type":"integer","minimum":2020,"maximum":2100,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year."},"required":true,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year.","name":"jaar","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":120,"description":"Age of the insured person on 1 January of jaar; supplementary premiums depend on age."},"required":false,"description":"Age of the insured person on 1 January of jaar; supplementary premiums depend on age.","name":"leeftijd","in":"query"},{"schema":{"type":"string","enum":["aanvullend","tand","combinatie"],"description":"Package kind: aanvullend (supplementary), tand (dental) or combinatie (both in one package)."},"required":false,"description":"Package kind: aanvullend (supplementary), tand (dental) or combinatie (both in one package).","name":"soort","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","description":"Insurer id (verzekeraar), e.g. 'vgz', as returned by list_verzekeraars."},"required":false,"description":"Insurer id (verzekeraar), e.g. 'vgz', as returned by list_verzekeraars.","name":"verzekeraarId","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":100000,"description":"Maximum premium per month in euro cents at this age, e.g. 2500 = 25 euros."},"required":false,"description":"Maximum premium per month in euro cents at this age, e.g. 2500 = 25 euros.","name":"maxPremieCentMaand","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","description":"Only packages that can be combined with this basic policy (polisId); most packages require a basic policy from the same insurer group (concern)."},"required":false,"description":"Only packages that can be combined with this basic policy (polisId); most packages require a basic policy from the same insurer group (concern).","name":"basisPolisId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Maximum number of results per page (1-50, default 10)."},"required":false,"description":"Maximum number of results per page (1-50, default 10).","name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":500,"description":"Opaque pagination cursor: pass meta.cursor from the previous response to get the next page."},"required":false,"description":"Opaque pagination cursor: pass meta.cursor from the previous response to get the next page.","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (Dutch, default) or en (English)."},"required":false,"description":"Response language: nl (Dutch, default) or en (English).","name":"taal","in":"query"},{"schema":{"type":"array","items":{"type":"string","pattern":"^[a-z_]+(:(minAantal|minBedragCent)=\\d+)*$"},"maxItems":10,"description":"Coverage requirement (eis), repeatable: '<categorie>' optionally followed by ':minAantal=<n>' and/or ':minBedragCent=<cent>', e.g. eis=fysio:minAantal=12&eis=tand_behandeling:minBedragCent=50000."},"required":false,"description":"Coverage requirement (eis), repeatable: '<categorie>' optionally followed by ':minAantal=<n>' and/or ':minBedragCent=<cent>', e.g. eis=fysio:minAantal=12&eis=tand_behandeling:minBedragCent=50000.","name":"eis","in":"query"}],"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (zoek_aanvullende_pakketten).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"pakketten":{"type":"array","items":{"type":"object","properties":{"polisId":{"type":"string"},"naam":{"type":"string"},"jaar":{"type":"integer"},"verzekeraarId":{"type":"string"},"verzekeraarLabel":{"type":"string"},"concern":{"type":"string"},"soort":{"type":"string","enum":["aanvullend","tand","combinatie"]},"premieCentMaand":{"type":["integer","null"]},"premieCentJaar":{"type":["integer","null"]},"acceptatie":{"type":"string","enum":["geen","vragenlijst","leeftijdsgrens","afwijzing_mogelijk"]},"maxInstapleeftijd":{"type":["integer","null"]},"wachttijdMaanden":{"type":"integer"},"kindGratis":{"type":"boolean"},"basisVereist":{"type":"boolean"},"dekkingen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"categorie":{"type":"string","enum":["fysio","oefentherapie","ergotherapie","logopedie","dietetiek","podotherapie","huidtherapie","tand_controle","tand_behandeling","tand_kronen_bruggen","orthodontie_kind","orthodontie_volwassen","tand_ongeval","bril_lenzen","ooglaser","hoortoestel","buitenland_spoed","buitenland_gepland","repatriering","vaccinaties_reis","alternatieve_geneeswijzen","acupunctuur","chiropractie_osteopathie","homeopathische_middelen","kraamzorg_eigen_bijdrage","bevalling_ziekenhuis_zonder_indicatie","anticonceptie","kinderopvang_ziek","ivf_extra","preventie_cursus","sportmedisch","stoppen_met_roken","dieetadvies","psychologische_zorg_extra","mindfulness","hulpmiddelen","medicijnen_eigen_bijdrage","plastische_chirurgie","sterilisatie","overgangsconsulent","herstel_zorghotel","mantelzorg_vervanging","overlijden_vervoer","eigen_risico_compensatie","medische_pedicure","stottertherapie","ontharing","camouflagetherapie","kunstgebit","orthoptie","buitenland_tand_spoed","buitenland_hulpverlening","kraampakket","kraamzorg_extra","lactatiekunde","zwangerschapscursus","therapeutisch_kamp","griepvaccinatie","beweegprogramma","gezondheidscheck","lidmaatschap_patientenvereniging","steunzolen","borstkolf","plaswekker","pruik","borstprothese","hospice","verblijf_bezoek","vervoer_verblijf_behandeling","ziekenvervoer_extra","mantelzorgmakelaar","mantelzorg_cursus","second_opinion","juridische_bijstand"]},"maxBedragCent":{"type":["integer","null"],"minimum":0},"percentage":{"type":["integer","null"],"minimum":0,"maximum":100},"maxAantal":{"type":["integer","null"],"minimum":0},"periode":{"type":"string","enum":["kalenderjaar","2jaar","3jaar","eenmalig","looptijd","4jaar","5jaar","per_gebeurtenis"]},"per":{"type":"string","enum":["persoon","polis"]},"eigenBijdrageCent":{"type":"integer","minimum":0},"eigenBijdragePer":{"type":"string","enum":["jaar","behandeling"]},"maxBedragPerBehandelingCent":{"type":["integer","null"],"minimum":0,"default":null},"gedeeldMet":{"type":"array","items":{"type":"string","enum":["fysio","oefentherapie","ergotherapie","logopedie","dietetiek","podotherapie","huidtherapie","tand_controle","tand_behandeling","tand_kronen_bruggen","orthodontie_kind","orthodontie_volwassen","tand_ongeval","bril_lenzen","ooglaser","hoortoestel","buitenland_spoed","buitenland_gepland","repatriering","vaccinaties_reis","alternatieve_geneeswijzen","acupunctuur","chiropractie_osteopathie","homeopathische_middelen","kraamzorg_eigen_bijdrage","bevalling_ziekenhuis_zonder_indicatie","anticonceptie","kinderopvang_ziek","ivf_extra","preventie_cursus","sportmedisch","stoppen_met_roken","dieetadvies","psychologische_zorg_extra","mindfulness","hulpmiddelen","medicijnen_eigen_bijdrage","plastische_chirurgie","sterilisatie","overgangsconsulent","herstel_zorghotel","mantelzorg_vervanging","overlijden_vervoer","eigen_risico_compensatie","medische_pedicure","stottertherapie","ontharing","camouflagetherapie","kunstgebit","orthoptie","buitenland_tand_spoed","buitenland_hulpverlening","kraampakket","kraamzorg_extra","lactatiekunde","zwangerschapscursus","therapeutisch_kamp","griepvaccinatie","beweegprogramma","gezondheidscheck","lidmaatschap_patientenvereniging","steunzolen","borstkolf","plaswekker","pruik","borstprothese","hospice","verblijf_bezoek","vervoer_verblijf_behandeling","ziekenvervoer_extra","mantelzorgmakelaar","mantelzorg_cursus","second_opinion","juridische_bijstand"]}},"stapelbaar":{"type":"boolean"},"voorwaardenTekst":{"type":["string","null"]},"bronId":{"type":["string","null"]},"bronAnchor":{"type":["string","null"]},"extractieStatus":{"type":"string","enum":["automatisch","gereviewed"]},"variant":{"type":"boolean","default":false},"rubriek":{"type":["string","null"],"maxLength":120,"default":null}},"required":["categorie","maxBedragCent","percentage","maxAantal","periode","per","eigenBijdrageCent","gedeeldMet","stapelbaar","voorwaardenTekst","bronId","bronAnchor","extractieStatus"]}},"afsluitUrl":{"type":["string","null"]},"detailUrl":{"type":["string","null"]},"bronIds":{"type":"array","items":{"type":"string"}}},"required":["polisId","naam","jaar","verzekeraarId","verzekeraarLabel","concern","soort","premieCentMaand","premieCentJaar","acceptatie","maxInstapleeftijd","wachttijdMaanden","kindGratis","basisVereist","dekkingen","afsluitUrl","detailUrl","bronIds"]}},"totaal":{"type":"integer","description":"Total number of matches across all pages."}},"required":["pakketten","totaal"]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}},"/zorgaanbieders":{"get":{"operationId":"zoek_zorgaanbieder","summary":"Search care providers","description":"Searches Dutch care providers (zorgaanbieders), such as hospitals, clinics and physiotherapists, in the national AGB register by name, city (plaats), postcode or care type (zorgsoort). Returns the AGB code, address and, when a postcode is given, the distance. Provide at least one of naam, plaats or postcode, then pass the AGB code to check_zorgaanbieder. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"parameters":[{"schema":{"type":"string","minLength":2,"maxLength":100,"description":"(Part of) the name of the care provider."},"required":false,"description":"(Part of) the name of the care provider.","name":"naam","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":80,"description":"City or town (plaats), e.g. Utrecht."},"required":false,"description":"City or town (plaats), e.g. Utrecht.","name":"plaats","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}\\s?([A-Za-z]{2})?$","description":"Dutch postcode (4 digits, optionally 2 letters), e.g. 3511 or 3511AB; results get a distance."},"required":false,"description":"Dutch postcode (4 digits, optionally 2 letters), e.g. 3511 or 3511AB; results get a distance.","name":"postcode","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":40,"pattern":"^[a-z][a-z0-9_]*$","description":"Type of care (zorgsoort), lowercase key such as 'ziekenhuis' (hospital), 'kliniek', 'ggz' (mental healthcare), 'fysio', 'wijkverpleging', 'apotheek'."},"required":false,"description":"Type of care (zorgsoort), lowercase key such as 'ziekenhuis' (hospital), 'kliniek', 'ggz' (mental healthcare), 'fysio', 'wijkverpleging', 'apotheek'.","name":"zorgsoort","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Maximum number of results per page (1-50, default 10)."},"required":false,"description":"Maximum number of results per page (1-50, default 10).","name":"limit","in":"query"},{"schema":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (Dutch, default) or en (English)."},"required":false,"description":"Response language: nl (Dutch, default) or en (English).","name":"taal","in":"query"}],"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (zoek_zorgaanbieder).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zorgaanbieders":{"type":"array","items":{"type":"object","properties":{"agbCode":{"type":"string"},"naam":{"type":"string"},"soort":{"type":"string"},"vestigingAgb":{"type":["string","null"]},"adres":{"type":["object","null"],"properties":{"straat":{"type":["string","null"]},"postcode":{"type":["string","null"]},"plaats":{"type":["string","null"]}},"required":["straat","postcode","plaats"]},"afstandKm":{"type":["number","null"]}},"required":["agbCode","naam","soort","vestigingAgb","adres","afstandKm"]}},"totaal":{"type":"integer","description":"Total number of matches across all pages."}},"required":["zorgaanbieders","totaal"]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}},"/zorgaanbieders/{agbCode}/contracten":{"get":{"operationId":"check_zorgaanbieder","summary":"Check care provider contract status","description":"Checks per basic policy whether a care provider (zorgaanbieder, by AGB code) has a contract with the insurer (gecontracteerd) for a care type (zorgsoort), and which percentage of the costs is reimbursed without a contract. Each result states its origin (herkomst: insurer publication, the insurer's provider search (zorgzoeker), or cache) and the date it was retrieved. If herkomst is null the dataset has no contract information for that policy (status onbekend); calling again does not change that. Contracts can change during the year, so suggest the user confirms with the insurer. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"parameters":[{"schema":{"type":"string","pattern":"^\\d{8}$","description":"AGB code (8 digits) of the care provider, from zoek_zorgaanbieder."},"required":true,"description":"AGB code (8 digits) of the care provider, from zoek_zorgaanbieder.","name":"agbCode","in":"path"},{"schema":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$"},"minItems":1,"maxItems":20,"description":"Basic policy ids (polisId) to check, e.g. from zoek_basisverzekeringen."},"required":true,"description":"Basic policy ids (polisId) to check, e.g. from zoek_basisverzekeringen.","name":"polisIds","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":40,"pattern":"^[a-z][a-z0-9_]*$","description":"Type of care (zorgsoort), lowercase key such as 'ziekenhuis' (hospital), 'kliniek', 'ggz' (mental healthcare), 'fysio', 'wijkverpleging', 'apotheek'."},"required":true,"description":"Type of care (zorgsoort), lowercase key such as 'ziekenhuis' (hospital), 'kliniek', 'ggz' (mental healthcare), 'fysio', 'wijkverpleging', 'apotheek'.","name":"zorgsoort","in":"query"},{"schema":{"type":"integer","minimum":2020,"maximum":2100,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year."},"required":true,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year.","name":"jaar","in":"query"},{"schema":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (Dutch, default) or en (English)."},"required":false,"description":"Response language: nl (Dutch, default) or en (English).","name":"taal","in":"query"}],"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (check_zorgaanbieder).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"agbCode":{"type":"string"},"zorgsoort":{"type":"string"},"zorgaanbieder":{"type":["object","null"],"properties":{"naam":{"type":"string"},"soort":{"type":"string"}},"required":["naam","soort"]},"resultaten":{"type":"array","items":{"type":"object","properties":{"polisId":{"type":"string"},"polisNaam":{"type":["string","null"]},"verzekeraarId":{"type":["string","null"]},"status":{"type":"string","enum":["gecontracteerd","deels","niet","onbekend"]},"vergoedingNietGecontracteerdPct":{"type":["integer","null"],"minimum":0,"maximum":100},"omzetplafond":{"type":["boolean","null"]},"herkomst":{"type":["string","null"],"enum":["publicatie","zorgzoeker","zorgweb","cache","wordt_opgehaald",null]},"opgehaaldOp":{"type":["string","null"]},"bronId":{"type":["string","null"]}},"required":["polisId","polisNaam","verzekeraarId","status","vergoedingNietGecontracteerdPct","omzetplafond","herkomst","opgehaaldOp","bronId"]}},"opnieuwProberenNaSeconden":{"type":["integer","null"]}},"required":["agbCode","zorgsoort","zorgaanbieder","resultaten","opnieuwProberenNaSeconden"]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}},"/jaarkosten":{"post":{"operationId":"bereken_jaarkosten","summary":"Calculate annual healthcare costs","description":"Calculates the expected total annual costs for a household scenario: basic and supplementary premiums, collective discount (collectiviteitskorting, supplementary only), expected deductible (eigen risico), statutory co-payments (eigen bijdragen) and care costs that are not reimbursed, per person and in total, with all assumptions (aannames) and warnings such as provisional premiums. Input is a Scenario: insurance year, 1 to 8 persons with year of birth, chosen policy ids, voluntary deductible and, only if the user volunteers it, planned care per taxonomy category with counts (verwachtGebruik, optional). Do not ask about health; never put diagnoses, medicines or free text in the scenario; get_intake_schema lists the questions and allowed categories. Children under 18 pay no basic premium and no deductible. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jaar":{"type":"integer","minimum":2020,"maximum":2100,"description":"Insurance year (verzekeringsjaar), e.g. 2027."},"personen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,32}$","description":"Short person id, e.g. 'p1'. Unique within the scenario."},"geboortejaar":{"type":"integer","minimum":1900,"maximum":2027,"description":"Year of birth (geboortejaar)."},"geboortemaand":{"type":"integer","minimum":1,"maximum":12,"description":"Month of birth (1-12), optional. Only used in the year the person turns 18 (premium and deductible start the month after the birthday); if omitted, June is assumed."},"polisBasisId":{"type":["string","null"],"minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","description":"Chosen or current basic policy (basisverzekering) id; null = not chosen yet."},"polisAanvullendIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$"},"maxItems":6,"default":[],"description":"Chosen supplementary and dental package (aanvullend/tand) ids."},"vrijwilligEigenRisico":{"type":"string","enum":["0","100","200","300","400","500"],"default":"0","description":"Voluntary deductible (vrijwillig eigen risico) in whole euros, on top of the mandatory deductible."},"verwachtGebruik":{"type":"array","items":{"type":"object","properties":{"categorie":{"type":"string","enum":["fysio","oefentherapie","ergotherapie","logopedie","dietetiek","podotherapie","huidtherapie","tand_controle","tand_behandeling","tand_kronen_bruggen","orthodontie_kind","orthodontie_volwassen","tand_ongeval","bril_lenzen","ooglaser","hoortoestel","buitenland_spoed","buitenland_gepland","repatriering","vaccinaties_reis","alternatieve_geneeswijzen","acupunctuur","chiropractie_osteopathie","homeopathische_middelen","kraamzorg_eigen_bijdrage","bevalling_ziekenhuis_zonder_indicatie","anticonceptie","kinderopvang_ziek","ivf_extra","preventie_cursus","sportmedisch","stoppen_met_roken","dieetadvies","psychologische_zorg_extra","mindfulness","hulpmiddelen","medicijnen_eigen_bijdrage","plastische_chirurgie","sterilisatie","overgangsconsulent","herstel_zorghotel","mantelzorg_vervanging","overlijden_vervoer","eigen_risico_compensatie","medische_pedicure","stottertherapie","ontharing","camouflagetherapie","kunstgebit","orthoptie","buitenland_tand_spoed","buitenland_hulpverlening","kraampakket","kraamzorg_extra","lactatiekunde","zwangerschapscursus","therapeutisch_kamp","griepvaccinatie","beweegprogramma","gezondheidscheck","lidmaatschap_patientenvereniging","steunzolen","borstkolf","plaswekker","pruik","borstprothese","hospice","verblijf_bezoek","vervoer_verblijf_behandeling","ziekenvervoer_extra","mantelzorgmakelaar","mantelzorg_cursus","second_opinion","juridische_bijstand","huisarts","medisch_specialist","medicijnen","ggz_basis","fysio_basis","hulpmiddelen_basis","ziekenvervoer","wijkverpleging","verloskunde","kraamzorg","lab_diagnostiek","mondzorg_basis","fysio_chronisch","fysio_artrose","fysio_etalagebenen","bekkenfysio","lab_huisartspraktijk","ziekenvervoer_zittend","medicijnen_gvs_bijdrage"],"description":"Care category code from the coverage taxonomy (e.g. fysio, tand_controle, huisarts). Never a diagnosis or medicine."},"aantal":{"type":"integer","minimum":0,"maximum":999,"description":"Expected number of treatments, sessions, hours or items in the year."},"tariefCentOverride":{"type":"integer","minimum":0,"maximum":2500000,"description":"Price per treatment in euro cents; omit to use the reference tariff (zorgtarief_referentie)."}},"required":["categorie","aantal"]},"maxItems":60,"default":[],"description":"Expected care use per category and count. No diagnoses, no free text."},"verwachtErPlichtigCent":{"type":"integer","minimum":0,"maximum":10000000,"description":"Expected deductible-liable (eigen-risicoplichtige) costs in euro cents; overrides the estimate from verwachtGebruik."},"vasteZorgaanbieders":{"type":"array","items":{"type":"object","properties":{"agbCode":{"type":"string","pattern":"^\\d{8}$","description":"AGB code (8 digits) of the care provider, from zoek_zorgaanbieder."},"zorgsoort":{"type":"string","minLength":2,"maxLength":40,"pattern":"^[a-z][a-z0-9_]*$","description":"Type of care, e.g. 'ziekenhuis', 'fysio', 'ggz'."}},"required":["agbCode","zorgsoort"]},"maxItems":10,"default":[],"description":"Care providers this person wants to keep using."}},"required":["id","geboortejaar","polisBasisId"]},"minItems":1,"maxItems":8,"description":"1 to 8 persons in the household, each with a unique id."},"termijn":{"type":"string","enum":["maand","kwartaal","halfjaar","jaar"],"default":"maand","description":"Premium payment term (betaaltermijn)."},"collectiefId":{"type":"string","minLength":1,"maxLength":100,"description":"Collective contract (collectiviteit) id, if any; discounts apply to supplementary only."},"taal":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (default) or en."}},"required":["jaar","personen"]}}}},"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (bereken_jaarkosten).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"jaar":{"type":"number"},"totaalCent":{"type":"number"},"perPersoon":{"type":"array","items":{"type":"object","properties":{"persoonId":{"type":"string"},"regels":{"type":"array","items":{"type":"object","properties":{"soort":{"type":"string","enum":["premie_basis","premie_aanvullend","korting_collectief","eigen_risico","eigen_bijdrage","niet_vergoed"]},"omschrijving":{"type":"string"},"bedragCent":{"type":"number"},"bronId":{"type":"string"},"aannames":{"type":"array","items":{"type":"string"},"default":[]}},"required":["soort","omschrijving","bedragCent"]}},"subtotaalCent":{"type":"number"}},"required":["persoonId","regels","subtotaalCent"]}},"aannames":{"type":"array","items":{"type":"string"}},"waarschuwingen":{"type":"array","items":{"type":"string"}}},"required":["engineVersie","datasetVersie","jaar","totaalCent","perPersoon","aannames","waarschuwingen"]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}},"/vergelijk":{"get":{"operationId":"vergelijk_polissen","summary":"Compare policies","description":"Compares 2 to 4 policies of the same insurance year and returns only the differences, grouped by aspect: premium (premie), choice of care providers (zorgkeuze), coverage per category (dekking), acceptance rules (acceptatie), waiting period (wachttijd), policy type and conditions (voorwaarden). Works for basic policies or for supplementary packages. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"parameters":[{"schema":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$"},"minItems":2,"maxItems":4,"description":"2 to 4 policy ids (polisId) of the same year: all basic policies or all supplementary packages."},"required":true,"description":"2 to 4 policy ids (polisId) of the same year: all basic policies or all supplementary packages.","name":"polisIds","in":"query"},{"schema":{"type":"integer","minimum":2020,"maximum":2100,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year."},"required":true,"description":"Insurance year (verzekeringsjaar), e.g. 2027. During the switching season (November-December) users usually mean the coming year.","name":"jaar","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["premie","zorgkeuze","dekking","acceptatie","wachttijd","type","voorwaarden"]},"minItems":1,"maxItems":7,"description":"Only compare these aspects: premie, zorgkeuze, dekking, acceptatie, wachttijd, type, voorwaarden. Default: all."},"required":false,"description":"Only compare these aspects: premie, zorgkeuze, dekking, acceptatie, wachttijd, type, voorwaarden. Default: all.","name":"aspecten","in":"query"},{"schema":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (Dutch, default) or en (English)."},"required":false,"description":"Response language: nl (Dutch, default) or en (English).","name":"taal","in":"query"}],"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (vergelijk_polissen).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"polissen":{"type":"array","items":{"type":"object","properties":{"polisId":{"type":"string"},"polisSoort":{"type":"string","enum":["basis","aanvullend"]},"naam":{"type":"string"},"jaar":{"type":"integer"},"verzekeraarId":{"type":"string"},"verzekeraarLabel":{"type":"string"}},"required":["polisId","polisSoort","naam","jaar","verzekeraarId","verzekeraarLabel"]}},"perAspect":{"type":"array","items":{"type":"object","properties":{"aspect":{"type":"string","enum":["premie","zorgkeuze","dekking","acceptatie","wachttijd","type","voorwaarden"]},"verschillen":{"type":"array","items":{"type":"object","properties":{"aspect":{"type":"string","enum":["premie","zorgkeuze","dekking","acceptatie","wachttijd","type","voorwaarden"]},"sleutel":{"type":"string"},"waardeA":{},"waardeB":{},"omschrijving":{"type":"string"},"polisIdA":{"type":"string"},"polisIdB":{"type":"string"}},"required":["aspect","sleutel","omschrijving","polisIdA","polisIdB"]}}},"required":["aspect","verschillen"]}},"aantalVerschillen":{"type":"integer"}},"required":["polissen","perAspect","aantalVerschillen"]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}},"/polissen/{polisId}/jaren":{"get":{"operationId":"vergelijk_jaren","summary":"Compare a policy across years","description":"Shows what changed in a policy between two insurance years (jaargangen), for example 2026 and 2027: premium, coverage per category, reimbursement of non-contracted care and conditions. Useful in the switching season (overstapseizoen) to explain why a policy became more expensive or lost coverage. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","description":"Policy id (polisId) of a basic policy or supplementary package, e.g. '2027-vgz-natura', as returned by the search tools."},"required":true,"description":"Policy id (polisId) of a basic policy or supplementary package, e.g. '2027-vgz-natura', as returned by the search tools.","name":"polisId","in":"path"},{"schema":{"type":"integer","minimum":2020,"maximum":2100,"description":"Earlier insurance year, e.g. 2026."},"required":true,"description":"Earlier insurance year, e.g. 2026.","name":"jaarA","in":"query"},{"schema":{"type":"integer","minimum":2020,"maximum":2100,"description":"Later insurance year, e.g. 2027."},"required":true,"description":"Later insurance year, e.g. 2027.","name":"jaarB","in":"query"},{"schema":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (Dutch, default) or en (English)."},"required":false,"description":"Response language: nl (Dutch, default) or en (English).","name":"taal","in":"query"}],"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (vergelijk_jaren).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"naam":{"type":"string"},"polisSoort":{"type":"string","enum":["basis","aanvullend"]},"verzekeraarId":{"type":"string"},"jaarA":{"type":"integer"},"jaarB":{"type":"integer"},"polisIdA":{"type":["string","null"]},"polisIdB":{"type":["string","null"]},"verschillen":{"type":"array","items":{"type":"object","properties":{"aspect":{"type":"string","enum":["premie","zorgkeuze","dekking","acceptatie","wachttijd","type","voorwaarden"]},"sleutel":{"type":"string"},"waardeA":{},"waardeB":{},"omschrijving":{"type":"string"},"jaarA":{"type":"integer"},"jaarB":{"type":"integer"}},"required":["aspect","sleutel","omschrijving","jaarA","jaarB"]}}},"required":["naam","polisSoort","verzekeraarId","jaarA","jaarB","polisIdA","polisIdB","verschillen"]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}},"/intake-schema":{"get":{"operationId":"get_intake_schema","summary":"Get intake questions","description":"Returns the ordered intake questionnaire for building a Scenario for bereken_jaarkosten: insurance year, persons with year of birth, optional planned care as categories and counts (only if the user offers it; no diagnoses), care providers to keep, preference for choice of providers, voluntary deductible (vrijwillig eigen risico), collective contract (collectiviteit), payment term and current policy. Each question lists its allowed values and the Scenario field it maps to. Ask only what is needed, in this order. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"parameters":[{"schema":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (Dutch, default) or en (English)."},"required":false,"description":"Response language: nl (Dutch, default) or en (English).","name":"taal","in":"query"}],"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (get_intake_schema).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"taal":{"type":"string","enum":["nl","en"]},"vragen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"vraag":{"type":"string"},"toelichting":{"type":"string"},"type":{"type":"string","enum":["getal","keuze","lijst","tekst"]},"verplicht":{"type":"boolean"},"toegestaneWaarden":{"type":"array","items":{"type":"object","properties":{"waarde":{"type":"string"},"label":{"type":"string"}},"required":["waarde","label"]}},"scenarioPad":{"type":["string","null"]},"filterPad":{"type":"string"}},"required":["id","vraag","toelichting","type","verplicht","scenarioPad"]}},"regels":{"type":"array","items":{"type":"string"}}},"required":["taal","vragen","regels"]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}},"/bronnen/{bronId}":{"get":{"operationId":"get_bron","summary":"Quote a source passage","description":"Returns a short passage (at most 500 characters, in Dutch) from an official source document (bron), such as an insurer's policy conditions (modelovereenkomst), coverage overview (vergoedingenwijzer), premium overview or a government publication, with its URL, version and date. Use a bronId and anchor (page or section) from the bronnen of another tool response to quote and cite the exact wording. Provides information, not advice: the user makes the decision and signs up with the insurer themselves.","tags":["tools"],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$","description":"Source id (bronId) from the bronnen list of another tool response."},"required":true,"description":"Source id (bronId) from the bronnen list of another tool response.","name":"bronId","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[A-Za-z0-9 ._#:-]+$","description":"Page or section within the source, e.g. 'p.14', from bronnen[].anchor."},"required":false,"description":"Page or section within the source, e.g. 'p.14', from bronnen[].anchor.","name":"anchor","in":"query"},{"schema":{"type":"string","enum":["nl","en"],"default":"nl","description":"Response language: nl (Dutch, default) or en (English)."},"required":false,"description":"Response language: nl (Dutch, default) or en (English).","name":"taal","in":"query"}],"responses":{"200":{"description":"Envelope with data, samenvatting, bronnen, aannames, meta and acties (get_bron).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"bronId":{"type":"string"},"titel":{"type":"string"},"type":{"type":"string","enum":["premieoverzicht","modelovereenkomst","vergoedingenwijzer","ziekenhuislijst","zorgzoeker","overheid"]},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]},"passage":{"type":"string","maxLength":500},"afgekapt":{"type":"boolean"}},"required":["bronId","titel","type","url","versie","datum","anchor","passage","afgekapt"]},"samenvatting":{"type":"string"},"bronnen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titel":{"type":"string"},"url":{"type":"string"},"versie":{"type":["string","null"]},"datum":{"type":["string","null"]},"anchor":{"type":["string","null"]}},"required":["id","titel","url","versie","datum","anchor"]}},"aannames":{"type":"array","items":{"type":"string"}},"meta":{"type":"object","properties":{"engineVersie":{"type":"string"},"datasetVersie":{"type":"string"},"taal":{"type":"string","enum":["nl","en"]},"gegenereerdOp":{"type":"string"},"sorteersleutel":{"type":"string"},"cursor":{"type":["string","null"]},"affiliateMelding":{"type":"string"}},"required":["engineVersie","datasetVersie","taal"]},"acties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["bewaar","afsluiten","bekijk"]},"label":{"type":"string"},"url":{"type":"string"}},"required":["type","label","url"]}}},"required":["data","samenvatting","bronnen","aannames","meta","acties"]}}}},"400":{"description":"Invalid input (validatie)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"404":{"description":"Not found (niet_gevonden)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"429":{"description":"Rate limit exceeded; see Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}},"500":{"description":"Internal error (intern)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["validatie","niet_gevonden","rate_limit","intern"]},"bericht":{"type":"string"}},"required":["code","bericht"]}}}}}}}},"webhooks":{}}