Skip to content
ParcelOps
Start free
All data sources

HUD Rents, Income Limits & ZIP Crosswalks API and MCP server

Bearer tokenhud-user

Official HUD Fair Market Rents, program income limits, area identifiers, and USPS ZIP-to-statistical-geography crosswalks.

HUD Rents, Income Limits & ZIP Crosswalks is published by US Department of Housing and Urban Development, HUD USER Data API and covers United States, District of Columbia, Puerto Rico, and HUD-published territories and areas.

It refreshes on a schedule the publisher sets.

Last verified . That is when these facts were last rebuilt from the ParcelOps source registry, not when US Department of Housing and Urban Development, HUD USER Data API last refreshed the data itself.

hudfair-market-rentincome-limitsaffordable-housingzip-crosswalkresidentialunited-states

API access

Your AI client reaches HUD Rents, Income Limits & ZIP Crosswalks through one ParcelOps MCP endpoint, so there is no separate key to hold for it and no per-source client to write. Reaching it takes your own credentials (Bearer token).

Set up HUD Rents, Income Limits & ZIP Crosswalks in Claude, ChatGPT, or CursorGet every fact on this page as JSON

Where it came from

PublisherUS Department of Housing and Urban Development, HUD USER Data API
Sourcehttps://www.huduser.gov/hudapi/public
API basehttps://www.huduser.gov/hudapi/public
Docshttps://www.huduser.gov/portal/dataset/fmr-api.html

Freshness and coverage

FreshnessScheduled · FMRs and Income Limits publish by HUD fiscal year; USPS crosswalks publish by year and quarter.
Places coveredUnited States, District of Columbia, Puerto Rico, HUD-published territories and areas
Time coveredNot declared
CredentialsCredentials required (Bearer token)

What this source cannot tell you

  • ⚠ Anything outside United States, District of Columbia, Puerto Rico, and HUD-published territories and areas. A request past that edge comes back empty rather than approximated.
  • ⚠ Which years it spans, because the covered period is not declared.
  • ⚠ Anything US Department of Housing and Urban Development, HUD USER Data API does not publish. ParcelOps returns this source as it stands and never fills a blank field from a different one.
  • ⚠ A free bearer token must be registered for each requested HUD dataset.
  • ⚠ FMRs and income limits are area/program benchmarks, not parcel facts, appraisals, or asking-rent estimates.
  • ⚠ HUD USER terms require the non-endorsement notice returned by every data method.

Methods (5)

A method is one call your agent can make against this source.

  • getFmr

    read

    Get HUD Fair Market Rents for a county/town or metro entity.

    What you must provideentityId
    Records returnedfair-market-rent-area
    How to get more resultsnone
    FreshnessScheduled (source-level)
    Input schema
    {
  "type": "object",
  "properties": {
    "entityId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{5,30}$"
    },
    "year": {
      "type": "integer",
      "minimum": 1980,
      "maximum": 2100
    }
  },
  "required": [
    "entityId"
  ],
  "additionalProperties": false
}
    • ⚠ Area rent benchmarks are not observed or estimated rent for an individual property.

  • getIncomeLimits

    read

    Get HUD median income and program income-limit tables for a county/town or metro entity.

    What you must provideentityId
    Records returnedhud-income-limit-area
    How to get more resultsnone
    FreshnessScheduled (source-level)
    Input schema
    {
  "type": "object",
  "properties": {
    "entityId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{5,30}$"
    },
    "year": {
      "type": "integer",
      "minimum": 1980,
      "maximum": 2100
    }
  },
  "required": [
    "entityId"
  ],
  "additionalProperties": false
}
    • ⚠ Use the applicable official HUD program file for final eligibility determinations.

  • listAreas

    read

    List HUD county/town or metro entity IDs used by the rent and income-limit methods.

    What you must providetype
    FreshnessScheduled (source-level)
    Input schema
    {
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "counties",
        "metros"
      ]
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "updated": {
      "type": "integer",
      "minimum": 1980,
      "maximum": 2100
    }
  },
  "required": [
    "type"
  ],
  "additionalProperties": false
}

  • getZipCrosswalk

    read

    Map one exact ZIP or Census/HUD geography through the HUD USPS crosswalk.

    What you must providetypequery
    Records returnedzip-statistical-geography-crosswalk
    How to get more resultsnone
    FreshnessScheduled (source-level)
    Input schema
    {
  "type": "object",
  "properties": {
    "type": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "query": {
      "type": "string",
      "minLength": 4,
      "maxLength": 11,
      "description": "Exact ZIP/GEOID appropriate for the selected crosswalk type. State-wide and All-file queries are rejected."
    },
    "year": {
      "type": "integer",
      "minimum": 1980,
      "maximum": 2100
    },
    "quarter": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    }
  },
  "required": [
    "type",
    "query"
  ],
  "additionalProperties": false
}
    • ⚠ Address-allocation ratios do not identify parcels or establish legal boundaries.

  • getServiceInfo

    read

    Return auth, attribution, rate limit, supported datasets, and use caveats.

    FreshnessScheduled (source-level)
    Input schema
    {
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

Where this source is used