Rent API

Typical rent, as JSON.

Send an address, a point, a census tract, ZIP code, city or county. Get back the typical rent and its range for studios to 4 bedrooms, and yearly rent growth.

POST https://api.pricedna.co/v1/rent
1
Endpoint
System status
100
Places per request
100
Free rent checks a month

Quick start

Send up to 100 places, of any kind. Each row says which area its figures describe.

Authenticate with your key in the X-PriceDNA-API-Key header.

curl -X POST https://api.pricedna.co/v1/rent \
  -H "X-PriceDNA-API-Key: $PRICEDNA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "places": [ { "tract": "37025042202" } ]
  }'

Places

Mix kinds freely in one request.

Headers
FieldDescription
X-PriceDNA-API-Key string required Your secret API key. Keep it server-side only.
Content-Type string required application/json
Idempotency-Key string Send the same key to retry safely. Within 24 hours, a repeat returns the first answer, marked Idempotent-Replayed: true, with no second charge.
Body
FieldDescription
places array required Places of any kind, mixed freely. One row comes back for each, in the same order.1 to 100 per request
Places
PlaceSendMeaning
Address text "123 Union St S, Concord, NC 28025" A US address. Answers for its census tract.
Address { "address": "123 Union St S, Concord, NC 28025" } The same, as an object. Answers for its census tract.
Point { "lat": 35.408416, "lng": -80.578372 } A point in the United States. Answers for its census tract.
Census tract { "tract": "37025042202" } An 11-digit census tract code.
ZIP code { "zip": "28025" } A five-digit ZIP code.
City { "city": "Concord", "state": "NC" } A city or town with its two-letter state.
County { "county": "37025" } A five-digit county FIPS code.

The response

One row per place, in the order sent. Here, a census tract with all five bedroom sizes.

{
  "results": [
    {
      "input": { "tract": "37025042202" },
      "status": "found",
      "reason": null,
      "message": null,
      "area": {
        "level": "tract",
        "geoid": "37025042202",
        "name": "Census tract 422.02, Cabarrus County, North Carolina"
      },
      "location": null,
      "rents": [
        { "bedrooms": 0, "typical": 1290, "low": 1060, "high": 1590 },
        { "bedrooms": 1, "typical": 1400, "low": 1160, "high": 1690 },
        { "bedrooms": 2, "typical": 1590, "low": 1330, "high": 1880 },
        { "bedrooms": 3, "typical": 1910, "low": 1560, "high": 2220 },
        { "bedrooms": 4, "typical": 2330, "low": 1910, "high": 2810 }
      ],
      "yearly_growth_percent": 4,
      "fair_market_rent": {
        "fiscal_year": 2027,
        "geography": {
          "level": "zip",
          "zip_codes": ["28025"],
          "hud_areas": []
        },
        "rents": [
          {
            "bedrooms": 0,
            "fmr": 1340,
            "low": 1340,
            "high": 1340,
            "percent_90": 1206,
            "percent_110": 1474
          },
          {
            "bedrooms": 1,
            "fmr": 1400,
            "low": 1400,
            "high": 1400,
            "percent_90": 1260,
            "percent_110": 1540
          },
          {
            "bedrooms": 2,
            "fmr": 1520,
            "low": 1520,
            "high": 1520,
            "percent_90": 1368,
            "percent_110": 1672
          },
          {
            "bedrooms": 3,
            "fmr": 1860,
            "low": 1860,
            "high": 1860,
            "percent_90": 1674,
            "percent_110": 2046
          },
          {
            "bedrooms": 4,
            "fmr": 2360,
            "low": 2360,
            "high": 2360,
            "percent_90": 2124,
            "percent_110": 2596
          }
        ]
      }
    }
  ],
  "rent_checks_used_this_month": 1,
  "rent_checks_left_this_month": 99,
  "rent_checks_per_month": 100,
  "rent_checks_purchased_left": 0,
  "resets_at": "2026-12-01T00:00:00-05:00"
}

Rows

Every row has every field, in the same order. A field that doesn’t apply is null. Half of recent movers nearby pay within the range.

Row fields
FieldDescription
input any The place you sent, as sent.
status enum Whether the place has figures. Every status but error counts as a rent check.found · not_found · invalid · outside_coverage · error
reason enum Why a row has no figures. Null when it has. Every reason is in the Reasons table below.no_figures · not_found · number_out_of_range · unknown_street · unknown_tract · invalid · incomplete · outside_coverage · lookup_unavailable · lookup_failed · timeout
message string The reason in plain words. Null when the row has figures.
area object The area the figures describe.
area.level enum The area the figures describe.tract · zip · city · county
area.geoid string The area’s code: tract, ZIP or county FIPS. Null for a city.
area.name string The area’s name.
location object Where an address or point was placed. Null for other places.
location.address string The address as placed. Null for a point.
location.lat number Latitude.
location.lng number Longitude.
rents array One entry per bedroom count, studio to 4 bedrooms. Dollars a month, to the nearest $10.
rents[].bedrooms integer 0 for a studio, up to 4 bedrooms.0 to 4
rents[].typical integer The middle rent for a home of that size in the area, on the lease, without utilities. Dollars a month.
rents[].low integer The low end of the range. For a census tract, the 25th percentile of rents recent movers pay. For a ZIP code, city or county, the middle of its tracts' figures.
rents[].high integer The high end of the range. For a census tract, the 75th percentile of rents recent movers pay. For a ZIP code, city or county, the middle of its tracts' figures.
yearly_growth_percent number Rent growth a year for the area, as a percent number (4.0 means 4%).
fair_market_rent object HUD’s fair market rent for the place, by bedroom count, with its fiscal year and the ZIP codes it comes from. Null when the row has no figures.
fair_market_rent.fiscal_year integer HUD’s fiscal year for the figures, which starts in October of the year before.
fair_market_rent.geography object Where HUD’s figure comes from: the ZIP codes used, or HUD’s metro or county area.
fair_market_rent.geography.level enum Where HUD’s figure comes from.zip · zip_codes · hud_area
fair_market_rent.geography.zip_codes array The ZIP codes whose Small Area figures were used.
fair_market_rent.geography.hud_areas array HUD’s metro or county areas whose figures were used, for ZIP codes with no Small Area figure. Usually empty.
fair_market_rent.geography.hud_areas[].code string HUD’s code for the area, such as METRO16740M16740.
fair_market_rent.geography.hud_areas[].name string HUD’s name for the area.
fair_market_rent.rents array One entry per bedroom count, studio to 4 bedrooms.
fair_market_rent.rents[].bedrooms integer 0 for a studio, up to 4 bedrooms.0 to 4
fair_market_rent.rents[].fmr integer HUD’s fair market rent, when every ZIP code used has the same one. Rent plus utilities, dollars a month. Null when the place spans ZIP codes with different figures; then see low and high.
fair_market_rent.rents[].low integer The lowest of HUD’s figures across the ZIP codes used. Equals fmr when there is one figure.
fair_market_rent.rents[].high integer The highest of HUD’s figures across the ZIP codes used. Equals fmr when there is one figure.
fair_market_rent.rents[].percent_90 integer 90% of fmr, HUD’s own column for a Small Area figure. Null when fmr is null.
fair_market_rent.rents[].percent_110 integer 110% of fmr, HUD’s own column for a Small Area figure. Null when fmr is null.

Area levels

An address or point answers for its census tract. A tract without figures of its own answers with its county’s, and area.level says so.

Area levels
ValueMeaning
tract The census tract of an address or point, or the tract you sent.
zip The ZIP code you sent.
city The city or town you sent.
county The county you sent, or the county of a tract without figures of its own.

Statuses

Each row says it has figures, or why not.

Statuses
StatusReasonsCounts as a rent checkMeaning
found null Yes Figures for the place. Every field is filled where it applies.
not_found no_figures not_found number_out_of_range unknown_street unknown_tract Yes We have no figures for the place, don’t know the tract code, or couldn’t place the address.
invalid invalid incomplete Yes Not a place we can read. message says what to send.
outside_coverage outside_coverage Yes Outside the 50 states and DC.
error lookup_unavailable lookup_failed timeout No The lookup couldn’t finish, or the request ran out of time before this row. Send it again.

Reasons

Why a row has no figures, and the message we send with it.

Reasons
ReasonStatusMessage
no_figures not_found “We have no rent figures for that place.”
not_found not_found “We couldn't find that address.”
number_out_of_range not_found Names the house numbers we know on that street, such as: We don't know 290 on Main St in Springfield. Known numbers run from 100 to 199. Check the address and try again.
unknown_street not_found “We can't find this street yet. If it's new, enter a nearby address.”
unknown_tract not_found “We don't know that census tract. Check its 11-digit code.”
invalid invalid Says what to send for the kind of place you sent, such as: Send the ZIP code as five digits.
incomplete invalid “Enter the full address: house number, street, city or ZIP, and state.”
outside_coverage outside_coverage “We cover addresses in the 50 states and DC.”
lookup_unavailable error “We couldn't finish this lookup. Send it again in a minute.”
lookup_failed error “We couldn't finish this lookup. Send it again in a minute.”
timeout error “We ran out of time before this row. Send it again; it was not counted.”

Sources

Typical rents describe the area. A single home’s rent depends on the home and its lease.

Built from public data: HUD Fair Market Rents, the Census Bureau’s American Community Survey and the Bureau of Labor Statistics, tuned to local rent growth trends with each PriceDNA data release. We don’t scrape listing sites to collect rents.

What’s included

The Free plan includes 100 rent checks a month. Paid plans include more.

  • 1 rent check per place you send, found or not. Places we couldn’t finish don’t count.
  • Resets at midnight Eastern time on the 1st.
  • Up to 100 places per request.
  • On Standard and Pro, rent checks from packs are used once the month’s are gone. Packs carry over while your account is open.
  • A request with more places than you have rent checks left, in the month and in packs, is refused whole, and nothing counts.

See paid plans

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 18000

{
  "type": "https://www.pricedna.co/api#error-no-rent-checks-left",
  "title": "No rent checks left this month",
  "status": 429,
  "detail": "You have 5 rent checks left this month. They reset on the 1st.",
  "code": "MONTHLY_RENT_CHECKS_USED",
  "rent_checks_left": 5,
  "resets_at": "2026-12-01T00:00:00-05:00",
  "rent_checks_per_month": 100,
  "rent_checks_purchased_left": 0
}

Errors

Errors arrive as problem details (RFC 9457), the same for all three APIs. See every error type.

Ready to start building?

Get your free API key