Properties
Get Properties by IDs
POST
Retrieve multiple properties by their DealMachine property IDs in a single request. Use this when you already have
dm_property_id values from a previous search or enrichment and want to fetch current data.
Each request accepts up to 250 IDs. The response preserves your input order and includes a
found flag for each item.Body Parameters
string[]
required
Array of DealMachine property IDs to retrieve (max 250).Example:
["prop_12345", "prop_67890"]boolean
default:true
Controls whether enriched data is returned and credits are consumed.
true (default) returns
enriched property fields plus contacts selected by contact_audience, with credits consumed per
entity. false enables preview mode and returns only base fields (address, coordinates, images,
bedrooms, bathrooms, and sqft) without consuming credits.string
default:"owners"
Which contacts to include with found properties. Defaults to
"owners".Options: owners, owners_and_family, renters, residents, all, noneWhen set (and not "none"), each found result includes a contacts array with match type flags. Use all to return every associated contact. Returned contacts consume people credits. Set to "none" to skip contacts.Response Fields
Found Result
Whenfound is true, the result contains comprehensive property data.
Not Found Result
Totals
Credits
Whenenrich=true (the default), this endpoint consumes 1 property data credit per found property. When contact_audience is set to a value other than "none" (default: "owners"), included contacts consume people credits. Not-found results are free. Credits are deduplicated within your billing period.
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).
Notes
- Response order matches your input order.
- Invalid ID formats (e.g., missing
prop_prefix) return an error object instead of a not-found result. - Items are looked up independently. One failed lookup does not affect others.
- For a single property, use GET /v1/properties/:id instead.