HUD - US Department of Housing and Urban Development · Schema

HUD Fair Market Rent

Schema for Fair Market Rent data returned by the HUD User FMR API

HousingGovernmentFair Market RentMortgageCommunity DevelopmentPublic HousingSection 8Income Limits

Properties

Name	Type	Description
area_name	string	Name of the geographic area (county or metro area)
area_code	string	HUD area code
county_name	string	County name if applicable
counties_msa	string	Counties within the MSA
year	string	Fiscal year for the FMR data
fmr_type	integer	FMR percentile type (40 or 50)
smallarea_status	string	Whether small area FMRs apply (0=No, 1=Yes)
basicdata	object	FMR values by bedroom size

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/hud/main/json-schema/hud-fair-market-rent-schema.json",
  "title": "HUD Fair Market Rent",
  "description": "Schema for Fair Market Rent data returned by the HUD User FMR API",
  "type": "object",
  "properties": {
    "area_name": {
      "type": "string",
      "description": "Name of the geographic area (county or metro area)"
    },
    "area_code": {
      "type": "string",
      "description": "HUD area code"
    },
    "county_name": {
      "type": "string",
      "description": "County name if applicable"
    },
    "counties_msa": {
      "type": "string",
      "description": "Counties within the MSA"
    },
    "year": {
      "type": "string",
      "description": "Fiscal year for the FMR data"
    },
    "fmr_type": {
      "type": "integer",
      "description": "FMR percentile type (40 or 50)",
      "enum": [40, 50]
    },
    "smallarea_status": {
      "type": "string",
      "description": "Whether small area FMRs apply (0=No, 1=Yes)",
      "enum": ["0", "1"]
    },
    "basicdata": {
      "type": "object",
      "description": "FMR values by bedroom size",
      "properties": {
        "Efficiency": {
          "type": "number",
          "description": "FMR for efficiency/studio unit in USD"
        },
        "One-Bedroom": {
          "type": "number",
          "description": "FMR for one-bedroom unit in USD"
        },
        "Two-Bedroom": {
          "type": "number",
          "description": "FMR for two-bedroom unit in USD"
        },
        "Three-Bedroom": {
          "type": "number",
          "description": "FMR for three-bedroom unit in USD"
        },
        "Four-Bedroom": {
          "type": "number",
          "description": "FMR for four-bedroom unit in USD"
        }
      },
      "required": ["Efficiency", "One-Bedroom", "Two-Bedroom", "Three-Bedroom", "Four-Bedroom"]
    }
  },
  "required": ["area_name", "year", "basicdata"]
}