Get Property

Retrieve a single property by its DealMachine property ID. Returns comprehensive property data including address, valuation, physical characteristics, tax, and mortgage information.

Path Parameters

path idstringrequired

DealMachine property ID (e.g., prop_12345).

Query Parameters

query enrichbooleandefault:

Controls whether enriched data is returned and credits are consumed. true (default) returns enriched property fields plus contacts selected by contact_audience. false enables preview mode and returns only base fields (address, coordinates, images, bedrooms, bathrooms, and sqft) without consuming credits.

query contact_audiencestringdefault: owners

Which contacts to include with the property. Defaults to "owners".

Options: owners, owners_and_family, renters, residents, all, none

When 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. Returned contacts consume people credits. Set to "none" to skip contacts.

If you only need property data, set contact_audience=none. The response omits contacts, skips contact lookup, and consumes zero people credits. Use the default owners audience only when you need owner records.

query fieldsstring

Comma-separated property field IDs from List Fields. Requires enrich=true. People fields such as has_pets belong on people lookups or people-anchored searches and are not property attributes.

Response Fields

Field	Type	Description
`dm_property_id`	string	DealMachine property ID
`full_address`	string	Complete formatted address
`address`, `city`, `state`, `zip`	string	Parsed address components
`latitude`, `longitude`	number	Property coordinates
`estimated_value`	number	Estimated market value
`estimated_equity_amount`	number	Estimated equity in dollars
`estimated_equity_percentage`	number	Estimated equity as percentage
`year_built`	number	Year the property was built
`living_area_sqft`	number	Interior living area in square feet
`lot_size_sqft`	number	Total lot size in square feet
`num_bedrooms`	number	Number of bedrooms
`num_bathrooms`	number	Number of bathrooms
`num_stories`	number	Number of stories
`owner_occupied`	boolean	Whether the owner lives at the property
`last_sale_date`	string	Date of last sale
`last_sale_amount`	number	Price of last sale
`total_assessed_value`	number	Tax assessor's total assessed value
`annual_property_tax_amount`	number	Annual property tax amount
`num_mortgages`	number	Number of active mortgages
`total_original_loan_amount`	number	Total original loan amount across all mortgages
`total_estimated_loan_balance`	number	Total estimated remaining loan balance
`apn`	string	Assessor's Parcel Number
`fips`	string	5-digit FIPS county code
`contacts`	array	Associated contacts. Only present when `contact_audience` is not `none`.

Credits

When enrich=true (the default), this endpoint consumes 1 property data credit for the property. When contact_audience is set to a value other than "none" (default: "owners"), included contacts consume people credits. Credits are deduplicated within your billing period, so 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).

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051{
  "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", "type": "wireless", "do_not_call": false }],
        "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
  }
}