Skip to main content
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_idDisplay NameDescription
all_mortgage_infoMortgagePrimary mortgage details including lender, balance, rate, loan type, and origination date
amenitiesAmenitiesProperty features such as pool, fireplace, garage, air conditioning, and parking
assessorAssessed ValuesCounty tax assessor valuations including land, improvement, and total assessed values
beds_and_bathsBeds and BathsBedroom and bathroom counts
building_informationBuilding InformationStructure details like year built, stories, square footage, and building class
condition_and_qualityCondition & QualityProperty condition rating and construction quality grade
construction_materialsConstruction MaterialsRoof type, exterior wall material, foundation, framing, and floor covering
equity_and_value_infoEquityEstimated equity amount and equity percentage based on current value minus outstanding loans
flood_informationFlood RiskFEMA flood zone designation
hoa_infoHOAHomeowners association fee amount and payment frequency
legal_infoLegalAPN (assessor parcel number) and legal description of the property
lien_informationLiensTax lien and involuntary lien indicators
lot_infoLot/LandLot size in acres and square feet, lot dimensions, and zoning classification
mls_infoListingMLS listing status, list price, days on market, and listing date
owner_typeOwnershipOwner name, occupancy status, absentee owner flag, corporate owner, trust-held, and ownership length
preforeclosure_infoPre-foreclosure & AuctionForeclosure status, default amount, auction date, trustee info, and recording details
sale_historySale HistoryPrior sale dates, prices, and buyer/seller information across multiple transactions
systems_and_utilitiesSystems & UtilitiesHeating, cooling, water, sewer, electrical, and fuel type
tax_and_mortgage_infoTaxAnnual tax amount, tax year, tax rate, and tax delinquency status

​
People Groups

Groups available when source_type is people.
group_idDisplay NameDescription
business_and_employmentBusiness/EmploymentOccupation, employer, job title, and business owner indicator
contactabilityContactabilityPhone availability, email availability, mailing address status, and contact scoring
credit_behaviorCredit BehaviorCredit score range, credit utilization, payment history, and credit age
credit_productsCredit ProductsActive credit cards, auto loans, student loans, and personal loan indicators
demographicsDemographicsAge, gender, marital status, education level, household size, ethnicity, and language
income_and_wealthIncome & WealthEstimated income range, net worth bracket, discretionary spending, and wealth score
insurance_behaviorInsurance BehaviorInsurance product ownership including auto, home, life, and health indicators
investment_activityInvestment ActivityStock/bond investor flag, active investor indicator, investment property count, and portfolio signals
investment_propertyInvestment PropertyDetails on owned investment properties including count, value, equity, and location
lifestyleLifestyle IndicatorsLifestyle interest indicators such as outdoor enthusiast, DIY, and charitable donor
loans_and_financingLoans & FinancingActive loan types, recent financing activity, and refinance likelihood
politicsPoliticsVoter registration status and party affiliation
primary_mortgageMortgageMortgage details on the person’s primary residence including lender, balance, rate, and term
primary_propertyResidence & PropertyPrimary residence details including property type, value, square footage, and year built
real_estateReal EstateTotal properties owned, years as property owner, recent purchase activity, and seller likelihood
vehicle_ownershipVehicle OwnershipVehicle 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"