Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Autocomplete Property Addresses

Return fast, bounded street-address suggestions from DealMachine property data. Every suggestion represents a DealMachine property and includes its property_id.
Autocomplete is free and does not perform property or person enrichment. It returns addresses only. Property searches, people, cities, counties, states, and ZIP-only queries are not suggestion types for this Endpoint.
GET /v1/locations/autocomplete remains available as a deprecated compatibility alias. New integrations should use this addresses Endpoint.

Query Parameters

query qstringrequired
At least two characters of a US property street address. Maximum 200 characters. The street address must begin with a house number.
query statestring
Optional two-letter state abbreviation used to narrow results.
query limitintegerdefault: 5
Maximum suggestions to return. Minimum 1 and maximum 10.
query latitudenumber
Optional latitude for nearby result ranking. longitude is required when this parameter is supplied.
query longitudenumber
Optional longitude for nearby result ranking. latitude is required when this parameter is supplied.

App integration best practices

Wait until the user has entered at least two characters, debounce requests for about 200 milliseconds, and cancel any previous request when the input changes. Keep limit=5 for most menus.
Use property_id to identify the selected DealMachine property. The address object contains the stored street, city, state, ZIP, full address, and coordinates when those values are available. The optional location object is normalized metadata for the returned address, not a separate location suggestion.
partial_results=true means fuzzy street matching was temporarily unavailable. Exact address-prefix results may still be returned.
Request example
curl "https://api.v2.dealmachine.com/v1/addresses/autocomplete?q=1200%20Barton%20Springs&state=TX&limit=5" \
  -H "Authorization: Bearer dm_sk_live_xxx"
Response example
{
  "data": [
    {
      "suggestion_id": "addr_prop_123",
      "kind": "address",
      "label": "1200 Barton Springs Rd, Austin, TX 78704",
      "property_id": "prop_123",
      "address": {
        "address": "1200 Barton Springs Rd",
        "city": "Austin",
        "state": "TX",
        "zip": "78704",
        "full_address": "1200 Barton Springs Rd, Austin, TX 78704",
        "latitude": 30.2638,
        "longitude": -97.7714
      },
      "location": {
        "location_id": "loc_city_7333",
        "type": "city",
        "code": "7333",
        "name": "Austin",
        "property_count": 460000,
        "state": "TX",
        "state_name": "Texas"
      }
    }
  ],
  "meta": {
    "query": "1200 Barton Springs",
    "limit": 5,
    "returned": 1,
    "partial_results": false
  }
}
DealMachine API
Powered byHolocron