Centers for Medicare and Medicaid Services · Schema

Household

If a household is not included, will default to Individual household

MedicareMedicaidHealthcareHealth InsuranceFHIRFederal GovernmentDrug SpendingProvider DataQuality MeasuresClaims Data

Properties

Name	Type	Description
income	number	household's yearly income in dollars
unemployment_received	string	Specifies whether a tax payer or tax dependent in the household received unemployment benefits for market year 2021. May affect ATPC and CSR calulations due to income percentage capping if income is a
people	array	people in household applying for coverage/seeking eligibility esimate; first is considered the subscriber
has_married_couple	boolean
effective_date	string	The effective date of the application (YYYY-MM-DD)

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Household",
  "description": "If a household is not included, will default to Individual household",
  "properties": {
    "income": {
      "description": "household's yearly income in dollars",
      "format": "float",
      "type": "number"
    },
    "unemployment_received": {
      "description": "Specifies whether a tax payer or tax dependent in the household received unemployment benefits for market year 2021. May affect ATPC and CSR calulations due to income percentage capping if income is above 133% of the Federal poverty level. If the person who received unemployment is a tax dependent, only the eligible CSRs will be affected. Defaults to None",
      "enum": [
        "Adult",
        "Dependent",
        "None"
      ],
      "type": "string"
    },
    "people": {
      "description": "people in household applying for coverage/seeking eligibility esimate; first is considered the subscriber",
      "items": {
        "$ref": "#/definitions/Person"
      },
      "type": "array"
    },
    "has_married_couple": {
      "type": "boolean"
    },
    "effective_date": {
      "description": "The effective date of the application (YYYY-MM-DD)",
      "type": "string",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
    }
  },
  "example": {
    "income": 20000,
    "people": [
      {
        "age": 34,
        "dob": "1984-01-06",
        "is_pregnant": false,
        "is_parent": false,
        "uses_tobacco": false,
        "gender": "Male"
      }
    ],
    "has_married_couple": false
  },
  "type": "object"
}