Property API

Property report, as JSON.

Send an address, the number of units and a goal for a rental property to buy. Get back the same report people see in the app, with the same sections in the same order.

Personalized real estate intelligence, as an API.

POST https://api.pricedna.co/v1/property
1
Endpoint
System status
2
Required fields
18
Optional parameters
<5s
Avg. response time

Quick start

Two fields are required: the address and the number of units. Everything else falls back to PriceDNA’s figures for the area, and the response marks which values you sent.

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

curl -X POST https://api.pricedna.co/v1/property \
  -H "X-PriceDNA-API-Key: $PRICEDNA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "123 Union St S, Concord, NC 28025",
    "number_of_units": 5,
    "asking_price": 849000,
    "monthly_rent": 1524,
    "goal": { "metric": "cash_velocity", "target": 200 },
    "mortgage_interest_rate": 7,
    "vacancy_rate": 5
  }'

The request

Analyzes a rental property to buy, from 1 to 500 units, against your goal. All rate and percentage parameters are plain numbers, such as 7.12 for 7.12%, not 0.0712.

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.
Property & Goal
FieldDescription
address string required Full US property address including street, city, state, and ZIP.
number_of_units integer required Total rentable units at the property.1 to 500
asking_price integer Purchase price in USD. Enables cash-on-cash, DSCR, and ROI calculations.$50,000 to $100,000,000
monthly_rent integer Average monthly rent per unit in USD. Defaults to local market rent.$200 to $25,000
goal object Your goal: the metric to optimize for and its target.
goal.metric enum Return metric to optimize for. Defaults to cash_on_cash_return.cash_on_cash_return · debt_service_coverage_ratio · cash_velocity
goal.target number Target for metric. Cash-on-cash return uses a percentage, DSCR uses a ratio, and cash velocity uses monthly dollars per unit. Defaults to a location-calibrated value.
goal_metric enum Same as goal.metric. Still accepted.cash_on_cash_return · debt_service_coverage_ratio · cash_velocity
goal_target number Same as goal.target. Still accepted.
Performance & Stabilization
FieldDescription
vacancy_rate number Expected vacancy as a percentage. Under 4% is tight; above 8% suggests softer demand. Defaults to market average.0 to 30%
management_fee_rate number Property management fee as a percentage of gross rent. Typically 3 to 12%.0 to 25%
upkeep_rate number Routine repairs and maintenance as a percentage of gross rent. Defaults to 10%.0 to 30%
reserve_rate number Reserve for replacements such as the roof, HVAC and water heater, as a percentage of gross rent. Defaults to 5%.0 to 30%
make_ready_amount integer One-time post-acquisition touch-up budget in USD. Often $0 for stabilized properties.$0 to $10,000,000
total_monthly_other_expenses integer Total landlord-paid monthly expenses not captured elsewhere (utilities, HOA, etc.) in USD for the whole property.$0 to $25,000 / month
Financing
FieldDescription
mortgage_interest_rate number Annual mortgage interest rate as a percentage. Defaults to current market rate for the location. A 0.5% change ≈ $180/mo on a $400k loan.0 to 25%
mortgage_term integer Loan term in years. Defaults to 30. Common values: 10, 15, 20, 25, 30.1 to 30 years
down_payment_percentage number Down payment as a percentage of purchase price. Typical: 20 to 25% for conventional loans.0 to 100%
closing_cost_percentage number Closing costs as a percentage of purchase price. Typically 2 to 5%; varies by lender and local taxes.0 to 10%
Location Dynamics
FieldDescription
property_tax_rate number Annual property tax as a percentage of assessed value. Varies by county and local levy.0 to 5%
Insurance
FieldDescription
property_insurance_rate number Standard property insurance as a percentage of property value annually. Typically 0.3 to 0.8%; higher in coastal areas.0 to 8%
flood_insurance_rate number Flood insurance as a percentage of property value. Applies only in flood zones; varies by elevation and coverage.0 to 8%
wind_insurance_rate number Wind insurance as a percentage of property value. Common in hurricane-prone regions.0 to 8%
Market value
FieldDescription
market_cap_rate number For 2+ units: the market cap rate the income value uses. Defaults to the county’s multifamily market cap rate, a starting point you can change. Ignored for a single house.1 to 25%

The response

One object per report section, in report order. Money is whole dollars, rates are percent numbers (5.2 means 5.2%), and nothing numeric arrives as a string.

estimatePriceDNA Estimate™ report: PriceDNA Estimate

The purchase price your goal can support, and how far the asking price is from it.

price
The goal-convergent price.
gap_percent
How far the asking price is above it.
summary
What the gap means, in words.
tone
The tone of the gap message: success, neutral or warning.
market_value
The market-facing number the report shows beside the estimate. For 2+ units, the income value: net operating income at the market cap rate, with tax and insurance loaded into the rate. For a single house, what single-family homes in the neighborhood appraised for, from FHFA. It never moves the estimate. Null when there is none.
method
income for 2+ units, neighborhood_appraisals for a single house.
value
The income value, or the neighborhood’s median appraised value.
net_operating_income
For income: the yearly NOI the value rests on.
market_cap_rate
For income: the market cap rate used, as a percent number.
low
For neighborhood_appraisals: the 25th percentile appraised value.
high
For neighborhood_appraisals: the 75th percentile appraised value.
year
For neighborhood_appraisals: the year of the appraisals.
level
For neighborhood_appraisals: tract, or county where the tract has too few appraisals to publish.
source
PriceDNA income value or FHFA Uniform Appraisal Dataset.
{
  "report_id": "93a2715c795b47b9acc2cf50dd2a7b76",
  "created_at": "2026-10-08T13:11:56Z",
  "links": {
    "report": "https://www.pricedna.co/reports/93a2715c795b47b9acc2cf50dd2a7b76"
  },
  "property": {
    "address": "123 Union St S, Concord, NC 28025",
    "lat": 35.4,
    "lng": -80.58,
    "asking_price": 849000,
    "units": 5,
    "flood_zone": false,
    "coastal_flood_zone": false
  },
  "goal": { "metric": "cash_velocity", "target": 200, "achieved": 200 },
  "estimate": {
    "price": 786000,
    "gap_percent": 8,
    "summary": "The asking price is 8.0% above your goal-convergent price.",
    "tone": "neutral",
    "market_value": {
      "method": "income",
      "value": 812000,
      "net_operating_income": 53600,
      "market_cap_rate": 6.6,
      "low": null,
      "high": null,
      "year": null,
      "level": null,
      "source": "PriceDNA income value"
    }
  },

projectionsProjected ROI path report: Projected ROI path

The return at 3, 5, 7 and 10 years, expected and in a downturn. Both use the same fields per year, so code that reads one reads the other.

expected
Price growth from the county’s market phase, rent growth from PriceDNA’s rent model.
downturn
The same deal through the area’s hardest downturn on record, with the county’s rents from those years. null when the area has none.
market_phase
The county’s market phase the expected price growth comes from: what the market is doing now and what usually followed in past markets. History, not a prediction. Null when the county has too little price history.
replays
Which drop: area, years, how far prices fell.
phase
downturn, recovery, boom, steady or slowed.
scope
For downturn and recovery: broad when the state is also in a downturn, else local.
years_in_phase
How many years in a row the county has been in this phase.
typical_years_left
How many more years such stretches usually lasted in past markets.
usually_followed_by
The phase such stretches most often turned into.
area
The county the phase describes.
summary
The same two sentences the report shows.
upfront_costs
Closing costs and make-ready.
net_gain
Appreciation, cash flow and loan paydown, after upfront costs.
roi
net_gain as a percent of cash_invested.
  "projections": {
    "cash_invested": 230000,
    "expected": {
      "years": [
        {
          "years": 3,
          "appreciation": 117000,
          "cash_flow": 43000,
          "loan_paydown": 19300,
          "upfront_costs": 33700,
          "net_gain": 145600,
          "roi": 63,
          "equity_multiple": 1.63
        }
      ]
    },
    "downturn": {
      "replays": {
        "area": "Cabarrus County",
        "name": "the housing crisis",
        "start_year": 2008,
        "end_year": 2013,
        "price_drop": 17,
        "rents_replayed": true
      },
      "years": [
        {
          "years": 3,
          "net_gain": -69600,
          "roi": -30,
          "equity_multiple": 0.7
        }
      ]
    },
    "market_phase": {
      "phase": "steady",
      "scope": null,
      "years_in_phase": 1,
      "typical_years_left": 3,
      "usually_followed_by": "slowed",
      "area": "Cabarrus County",
      "summary": "Cabarrus County’s market is growing steadily: prices are near their peak and rising at a typical pace. In past markets, steady stretches like this usually lasted about 3 more years, and most often turned into a slow stretch."
    }
  },

locationPriceDNA Location Score™ report: Location Score

How much the location supports the deal, from 0 to 100, and the six factors behind it, heaviest first.

score
0 to 100.
label
Excellent, very good, good, fair or poor.
factors
Each factor’s weight and rating.
  "location": {
    "score": 81,
    "label": "very good",
    "factors": [
      {
        "name": "economic_strength",
        "label": "Economic Strength",
        "weight": 28,
        "rating": "very good"
      },
      {
        "name": "rental_market",
        "label": "Rental Market",
        "weight": 22,
        "rating": "good"
      },
      {
        "name": "housing_market",
        "label": "Housing Market",
        "weight": 18,
        "rating": "good"
      },
      {
        "name": "climate_resilience",
        "label": "Climate Resilience",
        "weight": 12,
        "rating": "good"
      },
      {
        "name": "safety",
        "label": "Safety",
        "weight": 10,
        "rating": "good"
      },
      {
        "name": "urbanization",
        "label": "Urbanization",
        "weight": 10,
        "rating": "good"
      }
    ]
  },

neighborhoodNeighborhood report: Neighborhood

Who lives around the property and how deep the renter pool is, within 1, 3 and 5 miles. Census ACS.

renter_occupied
Share of homes rented, percent.
renter_age
Share of adults in prime renting ages.
  "neighborhood": [
    {
      "radius_mi": 1,
      "population": 4190,
      "households": 1466,
      "renter_occupied": 14.53,
      "renter_age": 37.21,
      "college_educated": 53.62,
      "vacant": 12.32
    }
  ],

nearby_influencesNearby influences on resale

What a listing won’t mention, within each category’s search radius. An empty found means nothing was detected.

  "nearby_influences": [
    {
      "category": "rail_tracks",
      "label": "Rail tracks",
      "radius_mi": 1,
      "found": [
        { "name": "NS", "distance_mi": 0.84 },
        { "name": "NS", "distance_mi": 0.85 }
      ]
    },
    {
      "category": "airports",
      "label": "Airports",
      "radius_mi": 4,
      "found": []
    }
  ],
  "market_pulse": [
    {
      "title": "100-year-old church in Concord transformed into affordable housing",
      "source": "wsoctv.com",
      "date": "2026-07-14",
      "url": "https://www.wsoctv.com/"
    }
  ],

deal_metricsDeal metrics report: Deal metrics

The ratios an investor checks. Return, financing and operating metrics are at the PriceDNA Estimate; the 1% rule and GRM at the asking price.

  "deal_metrics": {
    "cash_velocity": 200,
    "cash_on_cash_return": 5.2,
    "dscr": 1.26,
    "noi": 59100,
    "operating_cap_rate": 7.5,
    "opex_ratio": 32,
    "mortgage_payment": 3921,
    "total_investment": 230000,
    "one_percent_rule": 0.85,
    "grm": 9.8
  },

assumptionsAssumptions report: Assumptions

Every input the report used. entered is true for values you sent and false for PriceDNA’s figures, the same as the report’s Entered tag.

  "assumptions": [
    {
      "name": "monthly_rent",
      "label": "Monthly rent",
      "value": 1524,
      "unit": "$",
      "entered": true
    },
    {
      "name": "mortgage_interest_rate",
      "label": "Interest rate",
      "value": 7,
      "unit": "%",
      "entered": true
    },
    {
      "name": "vacancy_rate",
      "label": "Vacancy",
      "value": 5,
      "unit": "%",
      "entered": true
    },
    {
      "name": "property_tax_rate",
      "label": "Property tax",
      "value": 0.78,
      "unit": "%",
      "entered": false
    },
    {
      "name": "rent_growth",
      "label": "Rent growth",
      "value": "projected",
      "model": "PriceDNA rent growth model",
      "entered": false
    }
  ]
}

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