DiscoverSeniorBenefits

List the federal, state, and county senior-benefit programs that apply where a person lives, from their 5-digit ZIP code. Each program includes its cited government source URL, a last-verified date, and an apply-guide link on discoverseniorbenefits.com. Optionally filter by jurisdiction level or category keyword.

{
  "type": "object",
  "properties": {
    "zip": {
      "type": "string",
      "minLength": 5,
      "maxLength": 10,
      "description": "5-digit US ZIP code."
    },
    "level": {
      "type": "string",
      "enum": [
        "federal",
        "state",
        "county"
      ],
      "description": "Only return programs at this jurisdiction level."
    },
    "category": {
      "type": "string",
      "description": "Case-insensitive keyword matched against each program's category (e.g. 'food', 'property tax', 'utilities')."
    }
  },
  "required": [
    "zip"
  ],
  "additionalProperties": false
}

Check which senior-benefit programs a person likely qualifies for, using a deterministic rule engine tied to cited .gov sources — no AI guessing. Only age and zip_code are required; every extra field provided turns needs-more-info programs into definite answers. Include marital_status whenever known — many programs' income limits depend on it, so it resolves far more programs than most fields. The full guided check at https://discoverseniorbenefits.com/scan covers additional signals.

{
  "type": "object",
  "properties": {
    "age": {
      "type": "integer",
      "minimum": 0,
      "maximum": 120,
      "description": "Age of the person the check is for."
    },
    "zip_code": {
      "type": "string",
      "minLength": 5,
      "maxLength": 10,
      "description": "5-digit US ZIP code."
    },
    "household_income_annual": {
      "type": "integer",
      "minimum": 0,
      "description": "Approximate annual household income in dollars."
    },
    "household_size": {
      "type": "integer",
      "minimum": 1
    },
    "marital_status": {
      "type": "string",
      "enum": [
        "single",
        "married",
        "widowed",
        "divorced",
        "separated"
      ],
      "description": "High-leverage: several income limits are set per single vs. couple, so those programs stay needs-more-info until this is provided."
    },
    "veteran_status": {
      "type": "string",
      "enum": [
        "self",
        "spouse",
        "deceased_spouse",
        "none"
      ],
      "description": "Whether the person, spouse, or deceased spouse served."
    },
    "wartime_service": {
      "type": "boolean",
      "description": "90+ days active duty with at least one day in a VA wartime period."
    },
    "va_disability_rating": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100,
      "description": "VA disability rating (lower bound of the bucket)."
    },
    "homeownership": {
      "type": "string",
      "enum": [
        "own",
        "rent",
        "other"
      ]
    },
    "disability_status": {
      "type": "boolean"
    },
    "is_blind": {
      "type": "boolean"
    },
    "needs_personal_care_assistance": {
      "type": "boolean",
      "description": "Needs regular help with daily activities (bathing, meals, mobility)."
    },
    "has_cognitive_impairment": {
      "type": "boolean",
      "description": "Memory loss, dementia, or a cognitive condition affecting daily judgment."
    },
    "resources_estimate": {
      "type": "integer",
      "minimum": 0,
      "description": "Approximate countable savings/assets in dollars."
    },
    "is_us_citizen": {
      "type": "boolean"
    }
  },
  "required": [
    "age",
    "zip_code"
  ],
  "additionalProperties": false
}

Full public details for one program by its id (ids come from find_programs_by_zip or run_eligibility_scan): description, cited government source, how to apply, documents required, and the apply-guide link on discoverseniorbenefits.com.

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string",
      "description": "Program id, e.g. 'fed.msp.qmb'."
    },
    "state": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "2-letter state code; resolves state-specific application channels for federal programs."
    }
  },
  "required": [
    "program_id"
  ],
  "additionalProperties": false
}