---
title: "Autocomplete a US Property Address — Lookup API"
description: "Return up to 5 US street-level address suggestions from a partial address string, drawn from a national address graph. Free to call. Use it to validate input."
---

# Suggest US property addresses from a partial string

`GET /api/properties/auto-complete/`

Free

## What it returns

Up to 5 address suggestions matching a partial address string. Powered by a national address graph and curated to US street-level results only — city names, state codes, and ZIP codes alone return no matches.

## When to use it

- Power a typeahead input on a "lookup property" form.
- Resolve user-typed input to a canonical address string before calling `info` / `current-estimate`.
- Disambiguate between similar-named streets in the same city.

## Pricing

**Free — 0 credits.** Safe to fire on every keystroke (debounce in the client recommended for cost-of-network, not credits).

## Errors

| Status | Meaning |
|---|---|
| 400 | `input` parameter missing or shorter than 2 characters. |
| 401 | Authentication failed. |
| 503 | Upstream address service unavailable. Retry with backoff. |

## FAQ

### Does this work for commercial addresses?
No. Only US residential street addresses are returned. The endpoint upstream filters to `area_type == "address"` records only.

### Can I autocomplete by ZIP code?
No — ZIP-only input returns an empty `data` array. Provide a street fragment with at least one number or street word.