Skip to main content
GET
/
v1
/
people
/
{id}
curl "https://api.v2.dealmachine.com/v1/people/per_12345?include_properties=true" \
  -H "Authorization: Bearer dm_sk_live_xxx"

{
  "data": {
    "dm_person_id": "per_12345",
    "full_name": "John Smith",
    "first_name": "John",
    "last_name": "Smith",
    "middle_initial": "R",
    "person_age": 45,
    "estimated_household_income": 125000,
    "phones": [
      { "number": "5125551234" },
      { "number": "5125559999" }
    ],
    "emails": [
      { "address": "john.smith@example.com" }
    ],
    "properties": [
      {
        "dm_property_id": "prop_67890",
        "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",
        "is_likely_owner": true,
        "is_resident": true,
        "is_likely_renter": false
      }
    ]
  },
  "credits": {
    "used": 2,
    "properties": 1,
    "people": 1,
    "deduplicated": 0
  }
}
Retrieve a single person by their DealMachine person ID. Returns contact information including name, phone numbers, email addresses, and demographic data.

​
Path Parameters

​
id
string
required
DealMachine person ID (e.g., per_12345).

​
Query Parameters

​
enrich
boolean
default:true
Controls whether enriched data is returned and credits are consumed.
  • true (default) — Returns all person fields including phones, emails, and demographics. Credits are consumed.
  • false — Preview mode. Returns only base fields (name, match flags). No phones, emails, or demographic data. No credits are consumed.
​
include_properties
boolean
default:false
When true, includes the person’s associated properties with address, valuation, and ownership data.
curl "https://api.v2.dealmachine.com/v1/people/per_12345?include_properties=true" \
  -H "Authorization: Bearer dm_sk_live_xxx"

{
  "data": {
    "dm_person_id": "per_12345",
    "full_name": "John Smith",
    "first_name": "John",
    "last_name": "Smith",
    "middle_initial": "R",
    "person_age": 45,
    "estimated_household_income": 125000,
    "phones": [
      { "number": "5125551234" },
      { "number": "5125559999" }
    ],
    "emails": [
      { "address": "john.smith@example.com" }
    ],
    "properties": [
      {
        "dm_property_id": "prop_67890",
        "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",
        "is_likely_owner": true,
        "is_resident": true,
        "is_likely_renter": false
      }
    ]
  },
  "credits": {
    "used": 2,
    "properties": 1,
    "people": 1,
    "deduplicated": 0
  }
}

​
Response Fields

FieldTypeDescription
dm_person_idstringDealMachine person ID
full_namestringFull display name
first_name, last_namestringName components
middle_initialstringMiddle initial
agenumberEstimated age
estimated_household_incomenumberEstimated household income
genderstringGender (e.g., "Male", "Female")
marital_statusstringMarital status (e.g., "Married", "Single")
educationstringEducation level (e.g., "Bachelor's Degree")
occupationstringOccupation
occupation_groupstringOccupation group
languagestringPrimary language
net_asset_valuestringNet asset value range
phonesarrayPhone numbers, each with number
emailsarrayEmail addresses, each with address
propertiesarrayAssociated properties. Only present when include_properties=true.

​
Property Fields (when included)

FieldTypeDescription
dm_property_idstringDealMachine property ID
full_addressstringComplete formatted address
address, address_2, city, state, zipstringParsed address components
latitude, longitudenumberCoordinates
estimated_valuenumberEstimated market value
estimated_equity_amountnumberEstimated equity in dollars
estimated_equity_percentagenumberEstimated equity as percentage
year_builtnumberYear the property was built
living_area_sqftnumberInterior living area in square feet
lot_size_sqftnumberTotal lot size in square feet
num_bedroomsnumberNumber of bedrooms
num_bathroomsnumberNumber of bathrooms
num_storiesnumberNumber of stories
property_use_code_idnumberProperty use code
owner_occupiedbooleanWhether the owner lives at the property
last_sale_datestringDate of last sale
last_sale_amountnumberPrice of last sale
total_assessed_valuenumberTax assessor’s total assessed value
annual_property_tax_amountnumberAnnual property tax amount
num_mortgagesnumberNumber of active mortgages
total_original_loan_amountnumberTotal original loan amount
total_estimated_loan_balancenumberTotal estimated remaining loan balance
apnstringAssessor’s Parcel Number
fipsstring5-digit FIPS county code
is_likely_ownerbooleanWhether person is likely the owner
is_residentbooleanWhether person is a resident
is_likely_renterbooleanWhether person is likely a renter

​
Credits

When enrich=true (the default), this endpoint consumes 1 credit for the person. When include_properties=true, each included property costs 1 additional credit. Credits are deduplicated within your billing period — looking up the same person or property again is free. When enrich=false, no credits are consumed. Only base fields are returned (name, match flags). No phones, emails, or demographic data is included.