Skip to main content
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.
If you only need property data, set contact_audience to none. Each result omits contacts, skips contact lookup, and consumes zero people credits.

Response Fields

Found Result

When found is true, the result contains comprehensive property data.

Not Found Result

Totals

Credits

When enrich=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.