{"uid":"cap_fHKPQtqVs1zSN88JE1jOX","slug":"hud-income-limits-by-county-or-state-18847c33","name":"HUD Income Limits by County or State","description":"HUD Income Limits (IL) for a US county or state — the program-eligibility thresholds for HUD assistance, derived from Area Median Family Income: extremely-low (30% AMI), very-low (50% AMI), and low (80% AMI) income limits for household sizes 1–8, plus the area median income. Look up by 5-digit county FIPS or by 2-letter state. Optional year (defaults to latest). The raw HUD il30/il50/il80 codes are reshaped into clear nested limits by household size. Source: HUD USER Income Limits API (US public domain).","url":"https://2s.io/api/gov/income-limits","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":[],"properties":{"fips":{"type":"string","description":"5-digit US county FIPS, e.g. 06037."},"year":{"type":"string","description":"Income-limit year, e.g. 2026. Omit for latest."},"state":{"type":"string","description":"2-letter US state abbreviation, e.g. CA."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_W_q5w4JXgtR1_1OCjpPzr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns HUD program-eligibility income thresholds (extremely-low, very-low, and low) by household size for a US county or state, derived from Area Median Family Income","exampleAgentPrompt":"What are the HUD income limits for a household of 4 in Cook County, Illinois (FIPS 17031) for the latest year — give me the extremely-low, very-low, and low thresholds?","exampleUseCases":null,"resultDescription":"A nested JSON object with income limits broken down by household sizes 1–8 for three HUD tiers: extremely-low (30% AMI), very-low (50% AMI), and low (80% AMI), plus the area median family income for the requested county or state and year.","failureModes":["Invalid or non-existent FIPS code returns an error or empty result","State abbreviation not recognized returns a validation error","Year outside HUD's available data range returns an error","Neither fips nor state provided results in a missing-parameter error","HUD upstream API unavailability causes a 5xx or timeout response"],"whenToPreferThis":"Use this endpoint when you need official US government HUD income eligibility thresholds for housing assistance programs, broken down by household size and AMI tier, for a specific county (by FIPS) or state. Prefer this over generic income data sources when you need program-specific HUD definitions (30/50/80% AMI) rather than raw census income statistics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:39.936Z","isFirstParty":false}