Groups

Every filter and field belongs to a group — a logical category like “Ownership”, “Equity”, or “Demographics”. Groups are shared between the Filters and Fields APIs, so the same group_id works in both. Use the group_id to organize filter UIs, build category navigation, or request a focused subset of fields.

Filtering by Group

Pass group_id as a query parameter to scope discovery requests:

# Get all fields in the "equity_and_value_info" group
curl "https://api.v2.dealmachine.com/v1/fields?group_id=equity_and_value_info" \
  -H "Authorization: Bearer dm_sk_live_xxx"

# Get all filters in the "owner_type" group
curl "https://api.v2.dealmachine.com/v1/filters?group_id=owner_type" \
  -H "Authorization: Bearer dm_sk_live_xxx"

Property Groups

Groups available when source_type is properties.

`group_id`	Display Name	Description
`all_mortgage_info`	Mortgage	Primary mortgage details including lender, balance, rate, loan type, and origination date
`amenities`	Amenities	Property features such as pool, fireplace, garage, air conditioning, and parking
`assessor`	Assessed Values	County tax assessor valuations including land, improvement, and total assessed values
`beds_and_baths`	Beds and Baths	Bedroom and bathroom counts
`building_information`	Building Information	Structure details like year built, stories, square footage, and building class
`condition_and_quality`	Condition & Quality	Property condition rating and construction quality grade
`construction_materials`	Construction Materials	Roof type, exterior wall material, foundation, framing, and floor covering
`equity_and_value_info`	Equity	Estimated equity amount and equity percentage based on current value minus outstanding loans
`flood_information`	Flood Risk	FEMA flood zone designation
`hoa_info`	HOA	Homeowners association fee amount and payment frequency
`legal_info`	Legal	APN (assessor parcel number) and legal description of the property
`lien_information`	Liens	Tax lien and involuntary lien indicators
`lot_info`	Lot/Land	Lot size in acres and square feet, lot dimensions, and zoning classification
`mls_info`	Listing	MLS listing status, list price, days on market, and listing date
`owner_type`	Ownership	Owner name, occupancy status, absentee owner flag, corporate owner, trust-held, and ownership length
`preforeclosure_info`	Pre-foreclosure & Auction	Foreclosure status, default amount, auction date, trustee info, and recording details
`sale_history`	Sale History	Prior sale dates, prices, and buyer/seller information across multiple transactions
`systems_and_utilities`	Systems & Utilities	Heating, cooling, water, sewer, electrical, and fuel type
`tax_and_mortgage_info`	Tax	Annual tax amount, tax year, tax rate, and tax delinquency status

People Groups

Groups available when source_type is people.

`group_id`	Display Name	Description
`business_and_employment`	Business/Employment	Occupation, employer, job title, and business owner indicator
`contactability`	Contactability	Phone availability, email availability, mailing address status, and contact scoring
`credit_behavior`	Credit Behavior	Credit score range, credit utilization, payment history, and credit age
`credit_products`	Credit Products	Active credit cards, auto loans, student loans, and personal loan indicators
`demographics`	Demographics	Age, gender, marital status, education level, household size, ethnicity, and language
`income_and_wealth`	Income & Wealth	Estimated income range, net worth bracket, discretionary spending, and wealth score
`insurance_behavior`	Insurance Behavior	Insurance product ownership including auto, home, life, and health indicators
`investment_activity`	Investment Activity	Stock/bond investor flag, active investor indicator, investment property count, and portfolio signals
`investment_property`	Investment Property	Details on owned investment properties including count, value, equity, and location
`lifestyle`	Lifestyle Indicators	Lifestyle interest indicators such as outdoor enthusiast, DIY, and charitable donor
`loans_and_financing`	Loans & Financing	Active loan types, recent financing activity, and refinance likelihood
`politics`	Politics	Voter registration status and party affiliation
`primary_mortgage`	Mortgage	Mortgage details on the person’s primary residence including lender, balance, rate, and term
`primary_property`	Residence & Property	Primary residence details including property type, value, square footage, and year built
`real_estate`	Real Estate	Total properties owned, years as property owner, recent purchase activity, and seller likelihood
`vehicle_ownership`	Vehicle Ownership	Vehicle make, model, year, type, fuel type, and estimated value

Groups vs Source Types

Groups are scoped to a source type. Two groups can share the same display name across source types — for example, both all_mortgage_info (properties) and primary_mortgage (people) display as “Mortgage”, but they contain different fields. When using group_id in API requests, always pair it with the appropriate source_type:

# Property mortgage fields
curl "https://api.v2.dealmachine.com/v1/fields?source_type=properties&group_id=all_mortgage_info" \
  -H "Authorization: Bearer dm_sk_live_xxx"

# People mortgage fields
curl "https://api.v2.dealmachine.com/v1/fields?source_type=people&group_id=primary_mortgage" \
  -H "Authorization: Bearer dm_sk_live_xxx"

Getting Started

Searching

Data & Fields

Responses

Usage

CLI

Reference

AI Assistants

Filtering by Group

Property Groups

People Groups

Groups vs Source Types

​Filtering by Group

​Property Groups

​People Groups

​Groups vs Source Types

Filtering by Group

Property Groups

People Groups

Groups vs Source Types