For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact us
  • Introduction
    • Get Started
    • Authentication
    • Conventions
    • Filtering with FQL
    • Release Notes
  • API Reference
    • Activities
    • Amenities
    • Applications
    • Buildings
    • Customers
    • Deposits
    • Floor Plans
    • Households
    • Income Limits
      • GETList Income Limits
      • GETRead Income Limit
    • Leases
    • Listings
    • Maintenance
    • Move Ins
    • Move Outs
    • Properties
    • Prospects
    • Rent Changes
    • Reports
    • Reversals
    • Scheduled Reports
    • Scheduled Transactions
    • Screenings
    • Transactions
    • Turns
    • Units
    • Users
    • Work Orders
  • ILS Integration
Contact us
LogoLogo
On this page
  • Key Concepts
  • AMI Percentage
  • Household Size
  • Effective Date
  • Over-Income Threshold
  • Available Endpoints
API Reference

Income Limits Overview

Was this page helpful?
Previous

List Income Limits

Next
Built with

The Income Limits API provides access to the income eligibility limits for affordable housing programs at a property. These limits are derived from the property’s set-aside programs and reflect the maximum annual household income allowed under a given AMI (Area Median Income) percentage tier.

Key Concepts

AMI Percentage

Each income limit is tied to an AMI percentage tier (e.g. 50%, 60%, 80%) and program name (e.g. LIHTC-60%, HOME-50%). This represents the fraction of the Area Median Income for the local metro area that defines the income ceiling for that unit set-aside.

Household Size

Income limits vary by the number of people in the household. Each record represents a single combination of AMI percentage tier and household size (1–12 people), with a corresponding dollar amount.

Effective Date

Limits are updated annually (typically in April) as HUD publishes new AMI data. Use the effectiveDate field to identify which year’s limits apply.

Over-Income Threshold

The overIncomeThresholdPercentage field indicates how far above the income limit a household can be and still qualify under program rules. This varies by program — LIHTC allows up to 140% of the limit, while HOME uses 80%. This is critical for evaluating current residents at the end of a compliance period.

Available Endpoints

EndpointSummaryMethod
/incomeLimitsList Income LimitsGET
/incomeLimits/{incomeLimitId}Read Income LimitGET