API Reference

ListDeed Connect · v1

Real estate intelligence endpoints for investors and developers. Market metrics, legal layer data, geographic reference, and location risk — structured APIs no competitor offers.

1 endpoint · Regulations

1 endpoint · Platform Coverage

1 endpoint · Valuation

1 endpoint · AI Research

3 endpoints · Market Intelligence

3 endpoints · Legal Intelligence

3 endpoints · Geographic Reference

1 endpoint · Location Risk

1 endpoint · Address

Authentication

Every request requires your API key in the X-ListDeed-Key header. Keys are scoped to your account — never expose them in client-side code or public repositories.

Request header

X-ListDeed-Key: ld_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keep your key secret. Use environment variables or a secrets manager. Rotate via the dashboard if compromised.

Base URL

All endpoints

https://api.listdeed.com/v1/

All responses are application/json. All parameters are query string parameters unless otherwise noted.

Rate Limits

Rate limit state is returned on every response: X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset (Unix timestamp of next window reset).

Plan	Monthly calls	Burst limit
Included — bundled with any ListDeed subscription	1,000 calls	10 req/min
Pro — $49/month	50,000 calls	60 req/min
Enterprise — custom SLA	Unlimited	Negotiated

Error Codes

All errors return a JSON body with a message string and, when applicable, an errors array with per-field validation details.

Code	Name	Description
`400`	Bad Request	Missing or malformed required parameters. Check the errors array in the response body.
`401`	Unauthorized	Missing or invalid API key. Pass your key in the X-ListDeed-Key header.
`403`	Forbidden	Your key does not have access to this endpoint. Upgrade your plan or check key permissions.
`404`	Not Found	Resource not found (e.g. unsupported state code or city with no data).
`422`	Unprocessable Entity	Parameters failed validation (e.g. invalid state code). See errors array.
`429`	Too Many Requests	Rate limit exceeded. Check X-RateLimit-Remaining and X-RateLimit-Reset headers.
`500`	Internal Server Error	Unexpected server error. Retry with exponential backoff. Contact support if persistent.

Regulations

Live

Structured jurisdictional regulation data for US states. Query active rules by state, category (landlord_tenant, eviction, zoning…), or jurisdiction level. Sourced and reviewed annually by the ListDeed legal team.

GET/v1/regulations/lookup

NewLive

Regulations Lookup

Returns active jurisdictional regulations for a US state. Filter by category, subcategory, jurisdiction level (state / county / city / zip), county FIPS, or city name. Results are ordered most-specific-first (city > county > state). Cached 24 hours per unique parameter combination.

Legal data disclaimer

All /v1/legal/* responses include a disclaimer field and a last_reviewed_at date. Data reflects statutes in effect as of the review date and is reviewed annually. This data does not constitute legal advice — verify current statutes before acting.

Query Parameters

Param	Type	Required	Description
`state`	`string`	required	2-letter state code (uppercase, e.g. TX)
`category`	`string`	optional	landlord_tenant \| eviction \| creative_finance \| adverse_possession \| foreclosure \| zoning \| disclosure \| rent_control \| tax_deed_lien
`subcategory`	`string`	optional	Subcategory within the chosen category
`jurisdiction_level`	`string`	optional	state \| county \| city \| zip — scope to a specific level
`county_fips`	`string`	optional	5-digit FIPS county code
`city`	`string`	optional	City name — case-insensitive partial match

Request

curl

curl "https://api.listdeed.com/v1/regulations/lookup?state=TX&category=eviction" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

[
  {
    "id": "reg_tx_eviction_001",
    "jurisdiction_level": "state",
    "state_code": "TX",
    "county_fips": null,
    "city": null,
    "category": "eviction",
    "subcategory": "notice_periods",
    "title": "Texas Non-Payment Eviction Notice",
    "summary": "Landlord must provide 3 days written notice to vacate before filing a forcible detainer suit for non-payment of rent.",
    "structured_data": {
      "notice_days": 3,
      "notice_type": "written",
      "filing_court": "Justice of the Peace"
    },
    "source_citation": "TX Prop. Code §24.005",
    "source_url": "https://statutes.capitol.texas.gov/...",
    "effective_date": "1995-09-01",
    "status": "active",
    "verified_at": "2026-01-15",
    "last_reviewed_at": "2026-01-15"
  }
]

Response Fields

Field	Type	Description
`[]`	`object[]`	Array of active regulation objects (max 100), ordered most-specific-first.
`[].id`	`string`	Unique regulation ID
`[].jurisdiction_level`	`string`	state \| county \| city \| zip
`[].state_code`	`string`	2-letter state code
`[].county_fips`	`string \| null`	5-digit FIPS code (county/city records only)
`[].city`	`string \| null`	City name (city-level records only)
`[].category`	`string`	Regulation category
`[].subcategory`	`string`	Regulation subcategory
`[].title`	`string`	Short descriptive title
`[].summary`	`string`	Plain-English summary of the rule
`[].structured_data`	`object \| null`	Machine-readable rule parameters (key thresholds, timelines, amounts)
`[].source_citation`	`string \| null`	Statutory citation (e.g. TX Prop. Code §91.001)
`[].source_url`	`string \| null`	URL to the official statute or ordinance
`[].effective_date`	`string \| null`	Date the rule became effective (ISO 8601)
`[].status`	`string`	active \| pending \| expired
`[].verified_at`	`string \| null`	Date last verified by the ListDeed legal team
`[].last_reviewed_at`	`string \| null`	Date last reviewed against current statutes

Platform Coverage

Live

Real-time platform coverage stats — address database size, regulation counts by category, and geographic distribution from the BQ warehouse. No API key required. Safe to call from public dashboards.

GET/v1/coverage/summary

Live

Coverage Summary

Aggregate platform coverage stats merged from the BQ warehouse (via Vera) and live Supabase counts. Returns address totals, active regulations broken down by all 9 categories, and geographic coverage figures. Cached 6 hours.

Request

curl

curl "https://api.listdeed.com/v1/coverage/summary"

Response 200 OK

200application/json

{
  "addresses": 847293,
  "regulations": 35,
  "regulations_by_category": {
    "landlord_tenant": 10,
    "eviction": 5,
    "creative_finance": 4,
    "adverse_possession": 2,
    "foreclosure": 3,
    "zoning": 3,
    "disclosure": 2,
    "rent_control": 3,
    "tax_deed_lien": 3
  },
  "states": 10,
  "cities": 47,
  "zips": 24,
  "counties": 22,
  "data_points": 2880,
  "last_refreshed": "2026-04-22T18:30:00Z",
  "meta": { "cached": true }
}

Response Fields

Field	Type	Description
`addresses`	`number`	Total address records in the ListDeed database
`regulations`	`number`	Total active regulation records across all categories and states
`regulations_by_category`	`object`	Active count keyed by category: landlord_tenant, eviction, creative_finance, adverse_possession, foreclosure, zoning, disclosure, rent_control, tax_deed_lien
`states`	`number`	States with coverage in the BQ warehouse
`cities`	`number`	Cities with BQ warehouse coverage
`zips`	`number`	ZIP codes with BQ warehouse coverage
`counties`	`number`	Counties with BQ warehouse coverage
`data_points`	`number`	Total data points across all BQ warehouse tables
`last_refreshed`	`string \| null`	ISO 8601 timestamp of last BQ warehouse refresh
`meta.cached`	`boolean`	True if this response was served from the 6-hour Upstash cache

Valuation

Automated Valuation Model (AVM) estimates powered by Vera. Returns estimated market value, confidence interval, and comp-derived price-per-sqft for a specific property.

POST/v1/valuation/estimate

Live

AVM Estimate

Accepts a property address and optional attributes, returns an AVM point estimate with 80% confidence interval. Vera synthesises BQ warehouse comps, zip price index, and property condition to produce the estimate.

Query Parameters

Param	Type	Required	Description
`zip`	`string`	required	5-digit ZIP code of the property
`address`	`string`	required	Street address (e.g. 1234 Main St)
`sqft`	`number`	optional	Living area in sqft — improves estimate accuracy
`condition`	`string`	optional	excellent \| good \| fair \| poor (default: good)

Request

curl

curl -X POST "https://api.listdeed.com/v1/valuation/estimate" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"zip":"78702","address":"1234 East 6th Street","sqft":1450,"condition":"good"}'

Response 200 OK

200application/json

{
  "address": "1234 East 6th Street",
  "zip": "78702",
  "city": "Austin",
  "state": "TX",
  "estimated_value": 498000,
  "value_low": 462000,
  "value_high": 534000,
  "price_per_sqft": 343,
  "confidence": "high",
  "comp_count": 18,
  "as_of": "2026-03-15"
}

Response Fields

Field	Type	Description
`address`	`string`	Normalised property address
`zip`	`string`	ZIP code
`estimated_value`	`number`	AVM point estimate in USD
`value_low`	`number`	Low end of 80% confidence interval
`value_high`	`number`	High end of 80% confidence interval
`price_per_sqft`	`number \| null`	Implied $/sqft. null if sqft was not provided.
`confidence`	`string`	low \| medium \| high — based on comp density and data recency
`comp_count`	`number`	Comparable sales used to produce the estimate
`as_of`	`string`	Most recent comparable sale date used (ISO 8601)

AI Research

Natural language market research powered by Vera — ListDeed's AI intelligence layer. Ask questions about markets, investment strategy, regulations, and property data in plain English.

POST/v1/research/query

Live

Natural Language Research Query

Accepts a natural language question and optional geographic context. Vera synthesises platform data, BQ warehouse metrics, and regulation records to produce a structured answer with citations. Use depth: 'deep' for comprehensive analysis.

Query Parameters

Param	Type	Required	Description
`query`	`string`	required	Natural language question (e.g. "What is the eviction timeline in Texas for non-payment?")
`context.zip`	`string`	optional	ZIP code context to scope the answer
`context.city`	`string`	optional	City context
`context.state`	`string`	optional	2-letter state code context
`depth`	`string`	optional	quick (faster, concise) \| deep (comprehensive with full citations). Default: quick.

Request

curl

curl -X POST "https://api.listdeed.com/v1/research/query" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"query":"What is the eviction timeline in Texas?","context":{"state":"TX"},"depth":"quick"}'

Response 200 OK

200application/json

{
  "answer": "In Texas, the standard non-payment eviction process requires 3 days written notice to vacate, followed by a forcible detainer suit in Justice of the Peace court. An uncontested eviction typically completes in 21–30 days from notice to writ. Contested cases average 45–60 days.",
  "sources": [
    { "type": "regulation", "category": "eviction", "citation": "TX Prop. Code §24.005" }
  ],
  "confidence": "high",
  "depth": "quick",
  "processing_ms": 420
}

Response Fields

Field	Type	Description
`answer`	`string`	Synthesised plain-English answer
`sources`	`object[]`	Data sources cited in the answer (regulations, comps, BQ warehouse)
`confidence`	`string`	low \| medium \| high — based on data coverage for the query context
`depth`	`string`	quick \| deep — the depth tier used
`processing_ms`	`number`	Server-side processing time in milliseconds

Market Intelligence

Aggregate market metrics derived from anonymised community-reported comps, county records, and building permit data.

GET/v1/market/rehab-score

Phase 1

Market Rehab Momentum Score

Returns a 0–100 composite score representing active renovation momentum in a zip code. Derived from building permits, flip velocity, and active rehab listings. The leading indicator your competitors don't have.

Query Parameters

Param	Type	Required	Description
`zip`	`string`	required	5-digit US zip code
`months`	`number`	optional	Lookback window in months (3–24, default 6)

Request

curl

curl "https://api.listdeed.com/v1/market/rehab-score?zip=78702&months=6" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

{
  "zip_code": "78702",
  "city": "Austin",
  "state": "TX",
  "rehab_momentum_score": 73,
  "label": "Hot",
  "trend": "up",
  "trend_pct": 12.4,
  "confidence": "high",
  "as_of": "2026-03-01"
}

Response Fields

Field	Type	Description
`zip_code`	`string`	Requested zip code
`city`	`string`	Primary city for this zip
`state`	`string`	2-letter state code
`rehab_momentum_score`	`number`	0–100 composite score. Higher = more active renovation in the market.
`label`	`string`	Human-readable label: Cold \| Warming \| Active \| Hot \| Very Hot
`trend`	`string`	30-day trend direction: up \| flat \| down
`trend_pct`	`number`	Percentage change vs. prior period
`confidence`	`string`	Confidence tier based on sample count: low \| medium \| high
`as_of`	`string`	Date of most recent underlying data (ISO 8601)

GET/v1/market/investor-overview

Phase 1

Investor Market Overview

Full suite of investor-specific market metrics for a city. Covers investor purchase rate, flip velocity, gross flip margins, distressed pipeline depth, and platform deal flow — all in one call. No equivalent exists in any competing real estate API.

Query Parameters

Param	Type	Required	Description
`city`	`string`	required	City name (URL-encoded)
`state`	`string`	required	2-letter state code (uppercase)
`months`	`number`	optional	Lookback window in months (3–24, default 12)

Request

curl

curl "https://api.listdeed.com/v1/market/investor-overview?city=Austin&state=TX" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

{
  "city": "Austin",
  "state": "TX",
  "investor_purchase_rate_pct": 18.4,
  "flip_velocity_days": 142,
  "gross_flip_margin_pct": 24.7,
  "distressed_pipeline_count": 312,
  "platform_active_deals": 47,
  "market_tier": "secondary",
  "confidence": "high",
  "as_of": "2026-03-01"
}

Response Fields

Field	Type	Description
`city`	`string`	Requested city
`state`	`string`	2-letter state code
`investor_purchase_rate_pct`	`number`	Percentage of all sales in the period purchased by investors
`flip_velocity_days`	`number`	Median days from investor purchase to re-list (flipped properties)
`gross_flip_margin_pct`	`number`	Median gross profit margin on flipped properties in period
`distressed_pipeline_count`	`number`	Active pre-foreclosure + tax-delinquent property count in market
`platform_active_deals`	`number`	Active ListDeed deals in this market (opt-in community data only)
`market_tier`	`string`	Market classification: primary \| secondary \| tertiary \| rural
`confidence`	`string`	low \| medium \| high — based on underlying sample count
`as_of`	`string`	Date of most recent underlying data (ISO 8601)

GET/v1/market/comps

Phase 1

Comparable Sales Aggregates

Anonymised comparable sales aggregates for a zip code. Returns P25/median/P75 price per sqft, median days on market, and list-to-sale ratio. Source: anonymised community-reported comps from active ListDeed users.

Query Parameters

Param	Type	Required	Description
`zip`	`string`	required	5-digit US zip code
`months`	`number`	optional	Lookback window in months (3–24, default 6)
`property_type`	`string`	optional	sfr \| multi \| condo \| land \| commercial (default: sfr)

Request

curl

curl "https://api.listdeed.com/v1/market/comps?zip=78702&months=6&property_type=sfr" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

{
  "zip_code": "78702",
  "city": "Austin",
  "state": "TX",
  "property_type": "sfr",
  "sample_count": 83,
  "price_per_sqft": { "p25": 248, "median": 312, "p75": 389 },
  "days_on_market": { "median": 24 },
  "list_to_sale_ratio": 0.97,
  "confidence": "high",
  "as_of": "2026-02-28"
}

Response Fields

Field	Type	Description
`zip_code`	`string`	Requested zip code
`sample_count`	`number`	Comps in period. null if < 5 (minimum cohort enforcement)
`price_per_sqft.p25`	`number`	25th percentile price per sqft
`price_per_sqft.median`	`number`	Median price per sqft
`price_per_sqft.p75`	`number`	75th percentile price per sqft
`days_on_market.median`	`number`	Median days on market for sold properties
`list_to_sale_ratio`	`number`	Median (sale price ÷ list price). >1.0 = over asking.
`confidence`	`string`	low (5–19 comps) \| medium (20–49) \| high (50+)
`as_of`	`string`	Most recent comp date in the period (ISO 8601)

Legal Intelligence

API-exclusive

State and city landlord-tenant laws, squatter risk profiles, rent control ordinances, and tax lien/deed mechanics — structured as an API. No other real estate data provider offers this layer.

GET/v1/legal/landlord-risk

NewPhase 1

Landlord Risk Profile

Returns the complete landlord risk profile for a US state: eviction timelines, squatter adverse possession risk, rent control status, and security deposit rules. A 0–100 landlord friendliness score provides an at-a-glance investment climate signal. Pass an optional city to overlay city-specific rent control ordinances.

Legal data disclaimer

Query Parameters

Param	Type	Required	Description
`state`	`string`	required	2-letter state code (uppercase, e.g. TX)
`city`	`string`	optional	City name — overlays city-specific rent control and eviction protections if applicable

Request

curl

curl "https://api.listdeed.com/v1/legal/landlord-risk?state=TX" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

{
  "state": "TX",
  "state_name": "Texas",
  "landlord_friendliness_score": 87,
  "landlord_friendliness_label": "Very Landlord-Friendly",
  "eviction": {
    "notice_nonpayment_days": 3,
    "notice_violation_days": 3,
    "total_typical_days": 21,
    "total_contested_days": 60,
    "jury_trial_allowed": true,
    "self_help_eviction_allowed": false,
    "notes": "JP court handles most evictions. Writ issued 5 days after judgment."
  },
  "squatter_risk": {
    "adverse_possession_years": 10,
    "color_of_title_years": 3,
    "risk_level": "low"
  },
  "rent_control": {
    "state_preempts": true,
    "any_city_has_control": false,
    "status": "No Rent Control — State Prohibited"
  },
  "security_deposit": {
    "has_limit": false,
    "return_days": 30,
    "itemization_required": true
  },
  "city_overlay": null,
  "last_reviewed_at": "2026-01-15",
  "disclaimer": "For informational purposes only. Does not constitute legal advice."
}

Response Fields

Field	Type	Description
`state`	`string`	2-letter state code
`state_name`	`string`	Full state name
`landlord_friendliness_score`	`number`	0–100 composite score. 100 = most landlord-friendly.
`landlord_friendliness_label`	`string`	Very Landlord-Friendly \| Landlord-Friendly \| Neutral \| Tenant-Friendly \| Very Tenant-Friendly
`eviction.notice_nonpayment_days`	`number`	Days of notice required before filing for non-payment
`eviction.notice_violation_days`	`number`	Days of notice required for lease violations
`eviction.total_typical_days`	`number`	Typical duration of an uncontested eviction (days)
`eviction.total_contested_days`	`number`	Typical duration of a contested eviction (days)
`eviction.jury_trial_allowed`	`boolean`	Whether tenants can request a jury trial in eviction proceedings
`squatter_risk.adverse_possession_years`	`number`	Years of open, continuous occupancy required to claim adverse possession
`squatter_risk.risk_level`	`string`	very-low \| low \| medium \| medium-high \| high \| very-high
`rent_control.state_preempts`	`boolean`	True if state law prohibits local municipalities from enacting rent control
`rent_control.any_city_has_control`	`boolean`	True if any city in the state has active rent control ordinances
`security_deposit.has_limit`	`boolean`	Whether state caps the maximum security deposit amount
`security_deposit.return_days`	`number`	Days landlord has to return deposit after lease end
`city_overlay`	`object \| null`	City-specific ordinance overrides. null if no city passed or no local ordinances.
`last_reviewed_at`	`string`	Date data was last verified against current statutes (YYYY-MM-DD). Reviewed annually.
`disclaimer`	`string`	Legal disclaimer — always present in every /v1/legal/* response.

GET/v1/legal/tax-lien-info

NewPhase 1

Tax Lien / Deed Mechanics

Returns the complete tax foreclosure mechanics for a US state: lien vs. deed vs. hybrid classification, statutory interest rate, auction format, redemption period, and plain-English investor notes covering what to expect at auction and after.

Legal data disclaimer

Query Parameters

Param	Type	Required	Description
`state`	`string`	required	2-letter state code (uppercase, e.g. FL)

Request

curl

curl "https://api.listdeed.com/v1/legal/tax-lien-info?state=FL" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

{
  "state": "FL",
  "state_name": "Florida",
  "foreclosure_type": "judicial",
  "lien_or_deed": "lien",
  "interest_rate_pct": 18,
  "auction_type": "bid-down",
  "redemption_period_months": 24,
  "overbid_distribution": "investor_keeps",
  "typical_auction_months": 2,
  "typical_foreclosure_months": 18,
  "investor_notes": "Florida tax lien certificates are sold at bid-down rate auctions. Winning bidder receives the lowest accepted interest rate (statutory floor: 5%). Redemption period is 2 years. After expiry, apply for a tax deed via the county clerk.",
  "last_reviewed_at": "2026-01-15",
  "disclaimer": "For informational purposes only. Does not constitute legal advice."
}

Response Fields

Field	Type	Description
`state`	`string`	2-letter state code
`state_name`	`string`	Full state name
`foreclosure_type`	`string`	judicial \| non-judicial \| hybrid
`lien_or_deed`	`string`	lien \| deed \| hybrid — the investment vehicle type at auction
`interest_rate_pct`	`number \| null`	Maximum statutory annual interest rate. null for deed states.
`auction_type`	`string`	bid-down \| bid-up \| random-selection \| rotational
`redemption_period_months`	`number`	Months the owner has to pay off the lien after auction
`typical_auction_months`	`number`	Typical months from delinquency to tax lien auction
`typical_foreclosure_months`	`number`	Typical months from lien purchase to foreclosure (if not redeemed)
`investor_notes`	`string`	Plain-English narrative covering auction mechanics and key investor considerations
`last_reviewed_at`	`string`	Date last verified against current statutes (YYYY-MM-DD)
`disclaimer`	`string`	Legal disclaimer — always present

GET/v1/legal/market-legal-risk

NewPhase 1

Combined Market Legal Risk Score

Combines state landlord risk + city rent control overlay + physical risk (FEMA + EPA) + market metrics into a single composite legal risk score for investors. Includes curated plain-English narrative and a ranked list of investor actions for the market.

Legal data disclaimer

Query Parameters

Param	Type	Required	Description
`state`	`string`	required	2-letter state code (uppercase)
`city`	`string`	required	City name (URL-encoded)

Request

curl

curl "https://api.listdeed.com/v1/legal/market-legal-risk?state=CA&city=LosAngeles" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

{
  "state": "CA",
  "city": "Los Angeles",
  "legal_risk_score": 82,
  "legal_risk_label": "High Legal Risk for Landlords",
  "components": {
    "eviction_difficulty": { "score": 75, "label": "Difficult — 45–90 days typical" },
    "squatter_risk": { "score": 70, "label": "Medium-High — 5-year adverse possession" },
    "rent_control": { "score": 95, "label": "Strict — LA RSO, just cause required" },
    "security_deposit": { "score": 60, "label": "2-month cap, 21-day return" }
  },
  "plain_english_summary": "Los Angeles is one of the most tenant-friendly markets in the US. Evictions require just cause, rent increases are capped by the LA RSO, and courts typically take 45–90 days for an uncontested eviction.",
  "investor_actions": [
    "Budget 60–90 days vacancy for eviction scenarios",
    "Verify whether your property is subject to LA RSO before underwriting",
    "Inspect vacant properties frequently — CA's 5-year AP window is shortest in the US",
    "Consider requiring tenant liability insurance"
  ],
  "last_reviewed_at": "2026-01-15",
  "disclaimer": "For informational purposes only. Does not constitute legal advice."
}

Response Fields

Field	Type	Description
`state`	`string`	2-letter state code
`city`	`string`	Requested city
`legal_risk_score`	`number`	0–100 composite risk score. 100 = highest legal risk to landlords.
`legal_risk_label`	`string`	Low \| Moderate \| Elevated \| High \| Very High Legal Risk
`components.eviction_difficulty.score`	`number`	Sub-score for eviction process difficulty (0–100)
`components.squatter_risk.score`	`number`	Sub-score for squatter adverse possession risk (0–100)
`components.rent_control.score`	`number`	Sub-score for rent control severity (0–100)
`components.security_deposit.score`	`number`	Sub-score for security deposit restrictions (0–100)
`plain_english_summary`	`string`	Curated narrative interpretation of the full risk profile for this market. Written and verified annually.
`investor_actions`	`string[]`	Ranked list of recommended investor actions specific to this market
`last_reviewed_at`	`string`	Date last verified (YYYY-MM-DD)
`disclaimer`	`string`	Legal disclaimer — always present

Geographic Reference

New

Canonical geographic reference data: FIPS codes, MSA/CBSA classifications, market tiers, rent control flags, and city-level metadata for 5,000+ US markets.

GET/v1/geo/states

NewPhase 1

All States Overview

Returns all 50 states with landlord friendliness score, tax foreclosure type, and lien vs. deed classification — the fastest way to compare investment climates across states.

Request

curl

curl "https://api.listdeed.com/v1/geo/states" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

{
  "count": 50,
  "states": [
    {
      "state_code": "AZ", "state_name": "Arizona",
      "landlord_friendliness_score": 78, "landlord_friendliness_label": "Landlord-Friendly",
      "foreclosure_type": "non-judicial", "lien_or_deed": "lien",
      "interest_rate_pct": 16, "redemption_period_months": 3
    },
    {
      "state_code": "FL", "state_name": "Florida",
      "landlord_friendliness_score": 71, "landlord_friendliness_label": "Landlord-Friendly",
      "foreclosure_type": "judicial", "lien_or_deed": "lien",
      "interest_rate_pct": 18, "redemption_period_months": 24
    },
    {
      "state_code": "TX", "state_name": "Texas",
      "landlord_friendliness_score": 87, "landlord_friendliness_label": "Very Landlord-Friendly",
      "foreclosure_type": "non-judicial", "lien_or_deed": "deed",
      "interest_rate_pct": null, "redemption_period_months": 6
    }
  ]
}

Response Fields

Field	Type	Description
`count`	`number`	Total states returned (always 50)
`states[]`	`object[]`	Array of 50 state summary objects
`states[].state_code`	`string`	2-letter state code
`states[].state_name`	`string`	Full state name
`states[].landlord_friendliness_score`	`number`	0–100 composite landlord friendliness score
`states[].foreclosure_type`	`string`	judicial \| non-judicial \| hybrid
`states[].lien_or_deed`	`string`	lien \| deed \| hybrid
`states[].interest_rate_pct`	`number \| null`	Statutory annual rate (lien states only). null for deed states.
`states[].redemption_period_months`	`number \| null`	Redemption period in months. null for deed states.

GET/v1/geo/lookup

NewPhase 1

City / Market Lookup

Returns full geographic and legal metadata for a city in a single call: FIPS code, county, MSA/CBSA name, market tier, zip codes, rent control flag, landlord risk score, and tax foreclosure type.

Query Parameters

Param	Type	Required	Description
`city`	`string`	required	City name (URL-encoded)
`state`	`string`	required	2-letter state code (uppercase)

Request

curl

curl "https://api.listdeed.com/v1/geo/lookup?city=Austin&state=TX" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

{
  "state_code": "TX",
  "state_name": "Texas",
  "city_name": "Austin",
  "county_name": "Travis County",
  "fips_code": "48453",
  "metro_area": "Austin-Round Rock-Georgetown, TX",
  "market_tier": "secondary",
  "zip_codes": ["78701", "78702", "78703", "78704", "78705"],
  "has_city_rent_control": false,
  "has_city_eviction_protections": false,
  "is_investor_active": true,
  "landlord_risk": { "friendliness_score": 87, "label": "Very Landlord-Friendly" },
  "tax_type": "deed",
  "interest_rate_pct": null,
  "redemption_period_months": 6
}

Response Fields

Field	Type	Description
`state_code`	`string`	2-letter state code
`state_name`	`string`	Full state name
`city_name`	`string`	Canonical city name
`county_name`	`string`	County containing the city
`fips_code`	`string`	5-digit FIPS county code
`metro_area`	`string`	MSA/CBSA name (e.g. Austin-Round Rock-Georgetown, TX)
`market_tier`	`string`	primary \| secondary \| tertiary \| rural
`zip_codes`	`string[]`	ZIP codes within this city boundary
`has_city_rent_control`	`boolean`	True if city has active rent control ordinances
`has_city_eviction_protections`	`boolean`	True if city has additional eviction protections beyond state law
`is_investor_active`	`boolean`	True if ListDeed has active users in this market
`landlord_risk.friendliness_score`	`number`	State landlord friendliness score (0–100)
`landlord_risk.label`	`string`	Human-readable friendliness label
`tax_type`	`string`	lien \| deed \| hybrid
`interest_rate_pct`	`number \| null`	Statutory annual interest rate (lien states only)
`redemption_period_months`	`number \| null`	Redemption period in months after auction

GET/v1/geo/markets

NewPhase 1

Markets by State

Returns all tracked cities and markets for a given state with market tier, investor activity flag, and rent control indicator.

Query Parameters

Param	Type	Required	Description
`state`	`string`	required	2-letter state code (uppercase)
`tier`	`string`	optional	Filter: primary \| secondary \| tertiary \| rural
`investor_active`	`boolean`	optional	If true, only return markets with active ListDeed platform users

Request

curl

curl "https://api.listdeed.com/v1/geo/markets?state=TX&investor_active=true" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

{
  "state_code": "TX",
  "count": 8,
  "markets": [
    { "city_name": "Austin", "county_name": "Travis County", "market_tier": "secondary", "is_investor_active": true, "has_city_rent_control": false },
    { "city_name": "Houston", "county_name": "Harris County", "market_tier": "primary", "is_investor_active": true, "has_city_rent_control": false },
    { "city_name": "Dallas", "county_name": "Dallas County", "market_tier": "primary", "is_investor_active": true, "has_city_rent_control": false }
  ]
}

Response Fields

Field	Type	Description
`state_code`	`string`	2-letter state code
`count`	`number`	Number of markets returned
`markets[].city_name`	`string`	City name
`markets[].county_name`	`string`	County
`markets[].market_tier`	`string`	primary \| secondary \| tertiary \| rural
`markets[].is_investor_active`	`boolean`	Platform activity flag
`markets[].has_city_rent_control`	`boolean`	City-level rent control flag

Location Risk

Physical risk scores. FEMA flood zone data, EPA Superfund proximity, and composite environmental risk — pre-computed from bulk government datasets for sub-50ms responses.

GET/v1/location/risk

Phase 1

Location Risk Score

Returns FEMA flood zone classification, EPA Superfund site proximity, and a composite 0–100 environmental risk score for a zip code or lat/lng coordinate. Pre-computed from bulk FEMA NFHL shapefile and EPA Superfund dataset — no per-call government API latency.

Query Parameters

Param	Type	Required	Description
`zip`	`string`	optional	5-digit US zip code
`lat`	`number`	optional	Latitude — use with lng for point-level lookup
`lng`	`number`	optional	Longitude — use with lat

Request

curl

curl "https://api.listdeed.com/v1/location/risk?zip=78702" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

{
  "zip_code": "78702",
  "city": "Austin",
  "state": "TX",
  "flood_zone": "X",
  "flood_risk_label": "Minimal",
  "flood_risk_notes": "Zone X: outside the 500-year floodplain. No flood insurance required by lenders.",
  "superfund_nearby": false,
  "superfund_count_1mi": 0,
  "environmental_risk_score": 12,
  "confidence": "high",
  "as_of": "2026-01-01"
}

Response Fields

Field	Type	Description
`zip_code`	`string`	Zip code queried (or derived from lat/lng)
`flood_zone`	`string`	FEMA NFHL flood zone designation (e.g. X, A, AE, VE)
`flood_risk_label`	`string`	Minimal \| Low \| Moderate \| High \| Very High
`flood_risk_notes`	`string`	Plain-English flood zone description
`superfund_nearby`	`boolean`	True if any EPA Superfund site within 1 mile
`superfund_count_1mi`	`number`	Count of Superfund sites within 1 mile
`environmental_risk_score`	`number`	0–100 composite environmental risk (higher = more risk)
`confidence`	`string`	low \| medium \| high — based on spatial data coverage
`as_of`	`string`	Date of most recent underlying FEMA/EPA data (ISO 8601)

Address

Real estate-aware address search and autocomplete backed by 600M+ OpenAddresses records.

GET/v1/address/autocomplete

Phase 1

Address Autocomplete

Returns address suggestions for a partial input string. Backed by OpenAddresses (600M+ US addresses indexed in Typesense). Returns property attributes — beds, baths, sqft — alongside the address match for property-aware autocomplete UIs.

Query Parameters

Param	Type	Required	Description
`q`	`string`	required	Partial address string (minimum 3 characters)
`limit`	`number`	optional	Maximum results to return (1–10, default 5)
`state`	`string`	optional	Scope results to a specific state (2-letter code)

Request

curl

curl "https://api.listdeed.com/v1/address/autocomplete?q=1234+Main+St+Austin&limit=5" \
  -H "X-ListDeed-Key: ld_live_xxxxxxxxxxxx"

Response 200 OK

200application/json

{
  "query": "1234 Main St Austin",
  "results": [
    {
      "address": "1234 Main Street", "city": "Austin", "state": "TX", "zip": "78701",
      "county": "Travis County", "lat": 30.2672, "lng": -97.7431,
      "beds": 3, "baths": 2, "sqft": 1480
    },
    {
      "address": "1234 Main Street", "city": "Round Rock", "state": "TX", "zip": "78664",
      "county": "Williamson County", "lat": 30.5083, "lng": -97.6789,
      "beds": null, "baths": null, "sqft": null
    }
  ]
}

Response Fields

Field	Type	Description
`query`	`string`	The search query that was sent
`results[]`	`object[]`	Array of address matches ordered by relevance
`results[].address`	`string`	Full formatted street address
`results[].city`	`string`	City
`results[].state`	`string`	2-letter state code
`results[].zip`	`string`	ZIP code
`results[].county`	`string`	County name
`results[].lat`	`number`	Latitude (for map pinning and /v1/location/risk point lookups)
`results[].lng`	`number`	Longitude
`results[].beds`	`number \| null`	Bedroom count from property record (null if unavailable)
`results[].baths`	`number \| null`	Bathroom count (null if unavailable)
`results[].sqft`	`number \| null`	Square footage (null if unavailable)

Ready to start building?

Get your API key View pricing