---
title: "Get a Full Property Record — Property Lookup API"
description: "Retrieve the full record for one US residential property: address, coordinates, listing status and price, AVM value, size, beds, baths, and days on market."
---

# 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.