Input schema (JSON)
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"jaar",
"personen"
],
"properties": {
"jaar": {
"type": "integer",
"maximum": 2100,
"minimum": 2020,
"description": "Insurance year (verzekeringsjaar), e.g. 2027."
},
"taal": {
"enum": [
"nl",
"en"
],
"type": "string",
"default": "nl",
"description": "Response language: nl (default) or en."
},
"termijn": {
"enum": [
"maand",
"kwartaal",
"halfjaar",
"jaar"
],
"type": "string",
"default": "maand",
"description": "Premium payment term (betaaltermijn)."
},
"personen": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"geboortejaar",
"polisBasisId"
],
"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",
"maximum": 2027,
"minimum": 1900,
"description": "Year of birth (geboortejaar)."
},
"polisBasisId": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
"maxLength": 100,
"minLength": 1
},
{
"type": "null"
}
],
"description": "Chosen or current basic policy (basisverzekering) id; null = not chosen yet."
},
"geboortemaand": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"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."
},
"verwachtGebruik": {
"type": "array",
"items": {
"type": "object",
"required": [
"categorie",
"aantal"
],
"properties": {
"aantal": {
"type": "integer",
"maximum": 999,
"minimum": 0,
"description": "Expected number of treatments, sessions, hours or items in the year."
},
"categorie": {
"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"
],
"type": "string",
"description": "Care category code from the coverage taxonomy (e.g. fysio, tand_controle, huisarts). Never a diagnosis or medicine."
},
"tariefCentOverride": {
"type": "integer",
"maximum": 2500000,
"minimum": 0,
"description": "Price per treatment in euro cents; omit to use the reference tariff (zorgtarief_referentie)."
}
}
},
"default": [],
"maxItems": 60,
"description": "Expected care use per category and count. No diagnoses, no free text."
},
"polisAanvullendIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 6,
"description": "Chosen supplementary and dental package (aanvullend/tand) ids."
},
"vasteZorgaanbieders": {
"type": "array",
"items": {
"type": "object",
"required": [
"agbCode",
"zorgsoort"
],
"properties": {
"agbCode": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "AGB code (8 digits) of the care provider, from zoek_zorgaanbieder."
},
"zorgsoort": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]*$",
"maxLength": 40,
"minLength": 2,
"description": "Type of care, e.g. 'ziekenhuis', 'fysio', 'ggz'."
}
}
},
"default": [],
"maxItems": 10,
"description": "Care providers this person wants to keep using."
},
"vrijwilligEigenRisico": {
"enum": [
"0",
"100",
"200",
"300",
"400",
"500"
],
"type": "string",
"default": "0",
"description": "Voluntary deductible (vrijwillig eigen risico) in whole euros, on top of the mandatory deductible."
},
"verwachtErPlichtigCent": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Expected deductible-liable (eigen-risicoplichtige) costs in euro cents; overrides the estimate from verwachtGebruik."
}
}
},
"maxItems": 8,
"minItems": 1,
"description": "1 to 8 persons in the household, each with a unique id."
},
"collectiefId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Collective contract (collectiviteit) id, if any; discounts apply to supplementary only."
}
}
}