Year Fifteen MCP

{
  "type": "object",
  "required": [
    "state"
  ],
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "City as HUD lists it, e.g. \"Houston\"."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Rows to return (default 10, max 50). Sorted by units, largest first."
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter state or territory code, e.g. TX."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 5000,
      "minimum": 0,
      "description": "Rows to skip, for paging."
    },
    "min_units": {
      "type": "integer",
      "maximum": 5000,
      "minimum": 1,
      "description": "Only properties with at least this many total units."
    },
    "credit_type": {
      "enum": [
        "4%",
        "9%",
        "4% and 9%",
        "TCEP only"
      ],
      "type": "string",
      "description": "Credit type decoded from HUD's CREDIT field."
    },
    "compliance_end_year": {
      "type": "integer",
      "maximum": 2032,
      "minimum": 2023,
      "description": "Estimated year the 15-year compliance period ends (placed-in-service year + 14), e.g. 2027."
    }
  },
  "additionalProperties": false
}

{
  "title": "LIHTC properties reaching Year 15 in a state",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "hud_id"
  ],
  "properties": {
    "hud_id": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}[0-9]{8}$",
      "description": "HUD project id (HUD_ID): three letters and eight digits, e.g. AKA20090010. Find ids with find_year15_properties."
    }
  },
  "additionalProperties": false
}

{
  "title": "One LIHTC property and its Year 15 dates",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter state or territory code, e.g. CA. Omit for the national totals."
    }
  },
  "additionalProperties": false
}

{
  "title": "How many LIHTC properties reach Year 15, by year",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "extended_use_end_year": {
      "type": "integer",
      "maximum": 2120,
      "minimum": 2000,
      "description": "Extended use end year in the recorded agreement, if known and later than the federal minimum."
    },
    "placed_in_service_year": {
      "type": "integer",
      "maximum": 2030,
      "minimum": 1990,
      "description": "Year the building was placed in service, e.g. 2012. Omit for the exit paths only."
    },
    "credits_start_next_year": {
      "type": "boolean",
      "default": false,
      "description": "True if the owner elected on Form 8609 to start credits the year after placed in service."
    }
  },
  "additionalProperties": false
}

{
  "title": "Year 15 exit options and key dates",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}