Household calculate

Calculate tax and benefit impacts for a single household. Returns computed values for all variables.

Calculate household

POST/household/calculate

Calculate all tax and benefit variables for a household under current law or a policy reform.

Request body

{
  "tax_benefit_model_name": "policyengine_uk",
  "people": [
    {
      "age": 35,
      "employment_income": 50000
    }
  ],
  "household": {
    "region": "LONDON"
  },
  "year": 2026
}

https://v2.api.policyengine.org/household/calculate

Request parameters

tax_benefit_model_namepolicyengine_uk or policyengine_us

peopleArray of person objects with variable values (e.g., age, employment_income)

benunitUK: Benefit unit configuration

householdHousehold-level variables

yearSimulation year (default: 2026 UK, 2024 US)

policy_idUUID | null - Optional policy reform to apply

US-specific entities

marital_unitUS marital unit configuration

familyUS family configuration

spm_unitUS SPM unit configuration

tax_unitUS tax unit configuration