Full property record for a US residential property

GET /api/properties/info/

2 credits

What it returns

Full property record for a single US residential property — address, coordinates, listing status and price, AVM-estimated value, size, days on market, building/lot/parking/interior breakdown, listing-office details, recent property history, and nearby school ratings. Sourced from a national listing graph + Homesage.ai's AVM, hydrated on the first call per property and cached.

When to use it

Render a property-detail page in your UI.
Enrich a CRM lead record with the latest listing status and AVM.
Cross-check a third-party AVM against Homesage.ai's.
Look up listing-office contact info from a property address.

Pricing

2 credits per successful call. null returns from missing source data still cost 2 credits because the upstream call still ran. 404/401/402 cost 0 credits.

Errors

Status	Meaning
400	Neither property_address nor property_id provided, or property_id is not valid base64.
401	Authentication failed.
402	No subscription, or out of credits.
404	The autocomplete suggestion didn't match a real listing. Response includes did_you_mean suggestions.

FAQ

What's the difference between info and updated-info?

info is the fast lookup and may serve recently stored data. updated-info always returns the freshest available record (slower). Use updated-info when stale data matters — pricing decisions, just-listed alerts, post-sale follow-ups.

Why is listing_price null?

The property is not currently listed for sale. estimated_value (AVM) is still populated when available.

Can I look up by property_id instead of address?

Yes — pass property_id as a base64-encoded string. Use the id field returned by auto-complete.

How fresh are school ratings?

Refreshed annually from national school-ratings data.

Parameters

property_address (query, required) — Full US property address to look up.

Responses

200
400 — property_address is missing or could not be resolved to a property.
401 — Authentication failed — missing or invalid API key. Costs 0 credits.
402 — Payment required — no active subscription or insufficient credit balance. Costs 0 credits.
404 — Not found — the address could not be confidently matched to a single property. The body includes a did_you_mean array of suggested addresses (each with an mpr_id) to show the user and retry with; an empty array means no close match. Costs 0 credits.