Skip to main content
POST
Retrieve multiple people by their DealMachine person IDs in a single request. Use this when you already have dm_person_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 person IDs to retrieve (max 250).Example: ["per_12345", "per_67890"]
boolean
default:true
Controls whether enriched data is returned and credits are consumed.Set true (default) to return person fields including phones, emails, and demographics. Credits are consumed per entity. Set false for preview mode with base fields only. Preview mode omits phones, emails, and demographic data and consumes no credits.
boolean
default:false
When true, each found person includes a properties array with all associated properties.
integer
default:20
Maximum associated properties to return per person when include_properties=true. Maximum: 100.
string[]
Field IDs from List Fields. People fields return on each person. Property fields return under property.

Response Fields

Found Result

When found is true, the result contains person data with contact information.

Not Found Result

Totals

Credits

When enrich=true (the default), this endpoint consumes 1 people credit per found person. When include_properties is true, included properties consume property credits. Chargeable property fields requested through fields add property 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 (name, match flags). No phones, emails, or demographic data is included.

Notes

  • Response order matches your input order.
  • Invalid ID formats (e.g., missing per_ 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 person, use GET /v1/people/:id instead.