REST API · v1.0

Build with PriceDNA

Real Estate Intelligence as a Service

One call delivers the PriceDNA Estimate™, the PriceDNA Location Score™, and multi-horizon exit projections for income-producing properties — with customizable financial assumptions for pricing and projections.

1
Endpoint
2
Required fields
20+
Optional parameters
<2s
Avg. response time
POST https://api.pricedna.co/v1/analyze System status

Analyzes a multifamily investment property against your goals. Only address and number_of_units are required — all other parameters are optional and default to location-calibrated market values when omitted.

Required headers

X-PriceDNA-API-Key Your secret API key — keep server-side only.
Content-Type application/json
Property & Goal 2 required · 4 optional ▾
FieldTypeDescription
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 – 500
asking_price
integer optional
Purchase price in USD. Enables cash-on-cash, DSCR, and ROI calculations.
$50,000 – $100,000,000
monthly_rent
integer optional
Average monthly rent per unit in USD. Defaults to local market rent.
$200 – $25,000
goal_metric
enum optional
Return metric to optimize for. Defaults to cash_on_cash_return.
cash_on_cash_return · cap_rate · debt_service_coverage_ratio · cash_velocity
goal_target
number optional
Target for goal_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.
Performance & Stabilization 5 optional ▾
FieldTypeDescription
vacancy_rate
number optional
Expected vacancy as a percentage. Under 4% is tight; above 8% suggests softer demand. Defaults to market average.
0 – 30%
management_fee_rate
number optional
Property management fee as a percentage of gross rent. Typically 3–12%.
0 – 25%
repair_maintenance_capex_rate
number optional
Repairs, maintenance, and capex reserve as a percentage of gross rent. Typically 8–20% depending on property age.
0 – 30%
make_ready_amount
integer optional
One-time post-acquisition touch-up allowance in USD. Often $0 for stabilized properties.
$0 – $10,000,000
total_monthly_other_expenses
integer optional
Total landlord-paid monthly expenses not captured elsewhere (utilities, HOA, etc.) in USD for the whole property.
$0 – $25,000 / month
Financing 4 optional ▾
FieldTypeDescription
mortgage_interest_rate
number optional
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 – 25%
mortgage_term
integer optional
Loan term in years. Defaults to 30. Common values: 10, 15, 20, 25, 30.
1 – 30 years
down_payment_percentage
number optional
Down payment as a percentage of purchase price. Typical: 20–25% for conventional loans.
0 – 100%
closing_cost_percentage
number optional
Closing costs as a percentage of purchase price. Typically 2–5%; varies by lender and local taxes.
0 – 10%
Location Dynamics 4 optional ▾
FieldTypeDescription
property_tax_rate
number optional
Annual property tax as a percentage of assessed value. Varies by county and local levy.
0 – 5%
home_price_growth
number optional
Expected annual property value growth as a percentage, driven by local supply, demand, and job trends.
-10 – 20%
rent_growth
number optional
Expected annual rent increase as a percentage. Negative values model declining rent markets.
-10 – 30%
Insurance 3 optional ▾
FieldTypeDescription
property_insurance_rate
number optional
Standard property insurance as a percentage of property value annually. Typically 0.3–0.8%; higher in coastal areas.
0 – 8%
flood_insurance_rate
number optional
Flood insurance as a percentage of property value. Applies only in flood zones; varies by elevation and coverage.
0 – 8%
wind_insurance_rate
number optional
Wind insurance as a percentage of property value. Common in hurricane-prone regions.
0 – 8%
Note on percentage fields: All rate and percentage parameters are plain numbers — e.g. 7.12 for 7.12%, not 0.0712.
Headers

                  
Minimal (required only)

                  
curl

                  
Full example

                  
200 Success 400 Bad Request 401 Unauthorized 429 Rate Limited
200 Response

              

Ready to start building?

Create your account to get your API key. Every account starts with a 7-day trial that includes 7 analyses.

Get Your API Key →