Skip to main content
GET
/
v1
/
properties
/
{id}
curl "https://api.v2.dealmachine.com/v1/properties/prop_12345?contact_audience=owners" \
  -H "Authorization: Bearer dm_sk_live_xxx"

{
  "data": {
    "dm_property_id": "prop_12345",
    "full_address": "1200 Barton Springs Rd, Austin, TX 78704",
    "address": "1200 Barton Springs Rd",
    "city": "Austin",
    "state": "TX",
    "zip": "78704",
    "latitude": 30.2598,
    "longitude": -97.7544,
    "estimated_value": 575000,
    "estimated_equity_amount": 414000,
    "estimated_equity_percentage": 72,
    "year_built": 1985,
    "living_area_sqft": 2200,
    "lot_size_sqft": 8500,
    "num_bedrooms": 4,
    "num_bathrooms": 2,
    "num_stories": 2,
    "owner_occupied": true,
    "last_sale_date": "2018-06-15",
    "last_sale_amount": 380000,
    "total_assessed_value": 520000,
    "annual_property_tax_amount": 11440,
    "num_mortgages": 1,
    "total_original_loan_amount": 304000,
    "total_estimated_loan_balance": 161000,
    "apn": "0123456789",
    "fips": "48453",
    "contacts": [
      {
        "dm_person_id": "per_67890",
        "full_name": "John Smith",
        "first_name": "John",
        "last_name": "Smith",
        "phones": [
          { "number": "5125551234" }
        ],
        "emails": [
          { "address": "john.smith@example.com" }
        ],
        "is_likely_owner": true,
        "is_in_owner_family": false,
        "is_resident": true,
        "is_likely_renter": false
      }
    ]
  },
  "credits": {
    "used": 2,
    "properties": 1,
    "people": 1,
    "deduplicated": 0
  }
}
Retrieve a single property by its DealMachine property ID. Returns comprehensive property data including address, valuation, physical characteristics, tax, and mortgage information.

​
Path Parameters

​
id
string
required
DealMachine property ID (e.g., prop_12345).

​
Query Parameters

​
enrich
boolean
default:true
Controls whether enriched data is returned and credits are consumed.
  • true (default) — Returns all property fields plus contact data. Credits are consumed.
  • false — Preview mode. Returns only base fields (address, coordinates, images, bedrooms, bathrooms, sqft). No credits are consumed.
​
contact_audience
string
default:"owners"
Which contacts to include with the property. Defaults to "owners".Options: owners, owners_and_family, renters, residents, all, noneWhen set (and not "none"), the response includes a contacts array with match type flags. Use all to return every associated contact regardless of relationship type. Set to "none" to skip contacts and avoid contact credits.
curl "https://api.v2.dealmachine.com/v1/properties/prop_12345?contact_audience=owners" \
  -H "Authorization: Bearer dm_sk_live_xxx"

{
  "data": {
    "dm_property_id": "prop_12345",
    "full_address": "1200 Barton Springs Rd, Austin, TX 78704",
    "address": "1200 Barton Springs Rd",
    "city": "Austin",
    "state": "TX",
    "zip": "78704",
    "latitude": 30.2598,
    "longitude": -97.7544,
    "estimated_value": 575000,
    "estimated_equity_amount": 414000,
    "estimated_equity_percentage": 72,
    "year_built": 1985,
    "living_area_sqft": 2200,
    "lot_size_sqft": 8500,
    "num_bedrooms": 4,
    "num_bathrooms": 2,
    "num_stories": 2,
    "owner_occupied": true,
    "last_sale_date": "2018-06-15",
    "last_sale_amount": 380000,
    "total_assessed_value": 520000,
    "annual_property_tax_amount": 11440,
    "num_mortgages": 1,
    "total_original_loan_amount": 304000,
    "total_estimated_loan_balance": 161000,
    "apn": "0123456789",
    "fips": "48453",
    "contacts": [
      {
        "dm_person_id": "per_67890",
        "full_name": "John Smith",
        "first_name": "John",
        "last_name": "Smith",
        "phones": [
          { "number": "5125551234" }
        ],
        "emails": [
          { "address": "john.smith@example.com" }
        ],
        "is_likely_owner": true,
        "is_in_owner_family": false,
        "is_resident": true,
        "is_likely_renter": false
      }
    ]
  },
  "credits": {
    "used": 2,
    "properties": 1,
    "people": 1,
    "deduplicated": 0
  }
}

​
Response Fields

FieldTypeDescription
dm_property_idstringDealMachine property ID
full_addressstringComplete formatted address
address, city, state, zipstringParsed address components
latitude, longitudenumberProperty coordinates
estimated_valuenumberEstimated market value
estimated_equity_amountnumberEstimated equity in dollars
estimated_equity_percentagenumberEstimated equity as percentage
year_builtnumberYear the property was built
living_area_sqftnumberInterior living area in square feet
lot_size_sqftnumberTotal lot size in square feet
num_bedroomsnumberNumber of bedrooms
num_bathroomsnumberNumber of bathrooms
num_storiesnumberNumber of stories
owner_occupiedbooleanWhether the owner lives at the property
last_sale_datestringDate of last sale
last_sale_amountnumberPrice of last sale
total_assessed_valuenumberTax assessor’s total assessed value
annual_property_tax_amountnumberAnnual property tax amount
num_mortgagesnumberNumber of active mortgages
total_original_loan_amountnumberTotal original loan amount across all mortgages
total_estimated_loan_balancenumberTotal estimated remaining loan balance
apnstringAssessor’s Parcel Number
fipsstring5-digit FIPS county code
contactsarrayAssociated contacts. Only present when contact_audience is set.

​
Credits

When enrich=true (the default), this endpoint consumes 1 credit for the property. When contact_audience is set to a value other than "none" (default: "owners"), each included contact costs 1 additional credit. Credits are deduplicated within your billing period — looking up the same property or contact again is free. When enrich=false, no credits are consumed. Only base fields are returned (address, coordinates, images, bedrooms, bathrooms, sqft), and contacts include only names and match flags (no phones or emails).