People
Get People by IDs
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
Whenfound is true, the result contains person data with contact information.
Not Found Result
Totals
Credits
Whenenrich=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.