POST
$0.06 default
/2026/huurtoeslag/calculateDescription
Bereken huurtoeslag 2026
Documentation
Bereken huurtoeslag 2026
Deterministische 2026-schatting volgens officiële rekenhandleiding. Geen toets op recht: eligibility_confirmed en stable_full_year moeten expliciet bevestigd zijn. Onbevestigde/buitenlandse/gewijzigde situaties geven requires_review zonder bedrag. Geen periodeberekening; kinderopvang één opvangsoort per kind en 12 maanden werk/studie. Huurtoeslag gebruikt vooraf vastgesteld rekeninkomen na alle bewonersvrijstellingen.
POST JSON; maximum 32 KiB. Required fields must come from the caller. No BSN, name, address, credentials or inferred eligibility. Standard Apiosk quote and approval apply. Personal results use private, no-store; no shared upstream cache.
Pricing
$0.06 default
Authentication
Standard Apiosk buyer authentication and approval; no Nibud account or upstream key.
Parameters
{
"additionalProperties": false,
"properties": {},
"required": [],
"type": "object"
}Request schema
{
"additionalProperties": false,
"properties": {
"applicant_partner_assets_january1_eur": {
"description": "Toetsingsvermogen aanvrager plus partner op 1 januari, inclusief toegerekend vermogen minderjarige kinderen.",
"maximum": 99999999,
"minimum": 0,
"multipleOf": 0.01,
"type": "number"
},
"basic_rent_monthly_eur": {
"description": "Kale huur per maand; geen servicekosten. Woonwagen: inclusief standplaats.",
"maximum": 99999999,
"minimum": 0,
"multipleOf": 0.01,
"type": "number"
},
"context": {
"additionalProperties": false,
"properties": {
"annual_income_eur": {
"description": "Jaarlijks toetsingsinkomen van aanvrager plus eventuele toeslagpartner, in hele euros. Voor huurtoeslag: rekeninkomen van ALLE bewoners na wettelijke vrijstellingen, inclusief de kindvrijstelling. Geen netto maandinkomen.",
"maximum": 99999999,
"minimum": -99999999,
"type": "integer"
},
"country": {
"enum": [
"NL"
],
"type": "string"
},
"eligibility_confirmed": {
"description": "Alle toepasselijke basisvoorwaarden zijn expliciet door de gebruiker bevestigd (rechtmatig verblijf, inschrijving, toepasselijke verzekering/woning/kinderbijslag of werk/studie en geregistreerde betaalde opvang). NOOIT afleiden of standaard true invullen. Deze API stelt geen recht vast.",
"type": "boolean"
},
"has_partner": {
"description": "Toeslagpartner volgens Dienst Toeslagen, niet zomaar een huisgenoot.",
"type": "boolean"
},
"stable_full_year": {
"description": "Expliciete bevestiging dat relevante omstandigheden het hele jaar gelijk blijven: partner, huishouden, leeftijdsband, verzekering, huur en opvang. Kinderopvang: volledige 12 maanden werk/studie-eligibiliteit en dezelfde opvangsoort per kind. Wijzigingen vereisen periodeberekening en worden niet berekend.",
"type": "boolean"
},
"year": {
"const": 2026,
"type": "integer"
}
},
"required": [
"year",
"country",
"annual_income_eur",
"has_partner",
"eligibility_confirmed",
"stable_full_year"
],
"type": "object"
},
"eldest_age": {
"description": "Leeftijd oudste meetellende bewoner.",
"maximum": 130,
"minimum": 0,
"type": "integer"
},
"household_size": {
"description": "Alle meetellende bewoners; geen onderhuurders.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"other_resident_assets_january1_eur": {
"items": {
"description": "Per overige bewoner toetsingsvermogen op 1 januari; vul 0 voor minderjarige kinderen van wie vermogen al aan de ouder is toegerekend.",
"maximum": 99999999,
"minimum": 0,
"multipleOf": 0.01,
"type": "number"
},
"maxItems": 20,
"minItems": 0,
"type": "array"
},
"under21_exception": {
"description": "Jongerenuitzondering wegens kind, handicap of andere bijzondere situatie. true geeft requires_review.",
"type": "boolean"
}
},
"required": [
"context",
"basic_rent_monthly_eur",
"household_size",
"eldest_age",
"applicant_partner_assets_january1_eur",
"other_resident_assets_january1_eur",
"under21_exception"
],
"type": "object"
}Response schema
{
"properties": {
"coverage": {
"type": "object"
},
"data": {
"properties": {
"annual_formula_amount_eur": {
"type": [
"number",
"null"
]
},
"benefit": {
"type": "string"
},
"calculation": {
"type": "object"
},
"currency": {
"type": "string"
},
"monthly_amount_eur": {
"type": [
"integer",
"null"
]
},
"monthly_before_rounding_eur": {
"type": [
"number",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"ruleset": {
"type": "string"
},
"status": {
"enum": [
"estimate",
"requires_review"
],
"type": "string"
},
"year": {
"type": "integer"
}
},
"required": [
"benefit",
"year",
"ruleset",
"status",
"monthly_amount_eur",
"reason",
"calculation"
],
"type": "object"
},
"notice": {
"type": "string"
},
"sources": {
"items": {
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"required": [
"data",
"coverage",
"sources",
"notice"
],
"type": "object"
}Headers
{
"Content-Type": {
"description": "application/json",
"type": "string"
}
}Example request
{
"applicant_partner_assets_january1_eur": 0,
"basic_rent_monthly_eur": 1200,
"context": {
"annual_income_eur": 34000,
"country": "NL",
"eligibility_confirmed": true,
"has_partner": true,
"stable_full_year": true,
"year": 2026
},
"eldest_age": 30,
"household_size": 3,
"other_resident_assets_january1_eur": [
0
],
"under21_exception": false
}Example response
{
"coverage": {
"complete": false,
"eligibility_assessed": false,
"scope": "2026; Netherlands; unchanged relevant household and costs for the full year; eligibility conditions confirmed by caller",
"unsupported": [
"other years",
"foreign situations",
"changes during year",
"special statutory exceptions",
"application or entitlement decision"
]
},
"data": {
"annual_formula_amount_eur": 5904.4,
"benefit": "huurtoeslag",
"calculation": {
"asset_limit_applicant_partner_eur": 76958,
"asset_limit_per_other_resident_eur": 38479,
"base_rent_eur": 200.71,
"calculation_rent_eur": 932.93,
"income_reduction_eur": 45.83,
"income_threshold_eur": 31500,
"part_a_eur": 297.49,
"part_b_eur": 172.86,
"part_c_eur": 67.52
},
"currency": "EUR",
"monthly_amount_eur": 492,
"monthly_before_rounding_eur": 492.03,
"reason": null,
"ruleset": "nl-2026.1",
"status": "estimate",
"year": 2026
},
"notice": "Indicatieve berekening volgens de rekenregels van 2026, geen beschikking. Recht op toeslag is niet vastgesteld. Maandbedrag naar beneden afgerond volgens de rekenhandleiding; definitieve toekenning en betaaltermijnen kunnen afwijken.",
"sources": [
{
"publisher": "Dienst Toeslagen",
"url": "https://download.belastingdienst.nl/toeslagen/docs/berekening_huurtoeslag_tg0831z62fd.pdf",
"verified_at": "2026-10-13",
"year": 2026
}
]
}