curl --request POST \
  --url https://next.v3.dealmachine.com/api/property/lookup \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "street": "123 Main St",
  "city": "Austin",
  "state": "TX",
  "zip": "78701"
}
'

{
  "success": true,
  "data": {
    "property_id": 123,
    "apn_parcel_id": "<string>",
    "fips_code": "<string>",
    "property_address_full": "<string>",
    "property_address_line_1": "<string>",
    "property_address_line_2": "<string>",
    "property_address_city": "<string>",
    "property_address_state": "<string>",
    "property_address_zipcode": "<string>",
    "property_address_county": 123,
    "property_lat": 123,
    "property_lng": 123,
    "estimated_value": 123,
    "equity_amount": 123,
    "equity_percent": 123,
    "total_loan_amt": 123,
    "total_loan_balance": 123,
    "total_loan_payment": 123,
    "owner_1_name": "<string>",
    "owner_1_firstname": "<string>",
    "owner_1_lastname": "<string>",
    "owner_2_name": "<string>",
    "owner_2_firstname": "<string>",
    "owner_2_lastname": "<string>",
    "is_corporate_owner": true,
    "out_of_state_owner": true,
    "owner_address_full": "<string>",
    "building_square_feet": 123,
    "total_bedrooms": 123,
    "total_baths": 123,
    "year_built": 123,
    "property_type": "<string>",
    "units_count": 123,
    "stories": "<string>",
    "garage": true,
    "pool": true,
    "lot_acreage": 123,
    "lot_square_feet": 123,
    "legal_description": "<string>",
    "subdivision_name": "<string>",
    "school_district_name": "<string>",
    "zoning": "<string>",
    "flood_zone": "<string>",
    "tax_delinquent": true,
    "tax_amt": 123,
    "assd_total_value": 123,
    "assd_land_value": 123,
    "assd_improvement_value": 123,
    "calculated_total_value": 123,
    "calculated_land_value": 123,
    "calculated_improvement_value": 123,
    "sale_date": "2023-12-25",
    "last_sale_price": 123,
    "active_lien": true,
    "hoa_fee_amount": 123,
    "h_o_a1_name": "<string>",
    "num_mortgages": 123,
    "mortgages": [
      {
        "position": 2,
        "lien_position": 123,
        "loan_type": "<string>",
        "financing_type": "<string>",
        "interest_rate": 123,
        "has_adjustable_rate_rider": true,
        "start_date": "2023-12-25",
        "recording_date": "2023-12-25",
        "term_months": 123,
        "due_date": "2023-12-25",
        "lender_name": "<string>",
        "is_private_lender": true,
        "loan_amount": 123,
        "estimated_loan_balance": 123,
        "estimated_loan_payment": 123
      }
    ],
    "auction_date": "2023-12-25",
    "default_date": "2023-12-25",
    "property_flags": [
      "<string>"
    ],
    "contacts": [
      {
        "person_id": 123,
        "first_name": "<string>",
        "middle_initial": "<string>",
        "last_name": "<string>",
        "mailing_address": "<string>",
        "mailing_city": "<string>",
        "mailing_state": "<string>",
        "mailing_zip": "<string>",
        "type": [
          "owner",
          "resident"
        ],
        "phones": [
          {
            "number": "<string>",
            "do_not_call": true
          }
        ],
        "emails": [
          "jsmith@example.com"
        ]
      }
    ]
  },
  "usage": {
    "current": 123,
    "limit": 123,
    "warning": "<string>"
  }
}

POST

api

property

lookup

curl --request POST \
  --url https://next.v3.dealmachine.com/api/property/lookup \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "street": "123 Main St",
  "city": "Austin",
  "state": "TX",
  "zip": "78701"
}
'

{
  "success": true,
  "data": {
    "property_id": 123,
    "apn_parcel_id": "<string>",
    "fips_code": "<string>",
    "property_address_full": "<string>",
    "property_address_line_1": "<string>",
    "property_address_line_2": "<string>",
    "property_address_city": "<string>",
    "property_address_state": "<string>",
    "property_address_zipcode": "<string>",
    "property_address_county": 123,
    "property_lat": 123,
    "property_lng": 123,
    "estimated_value": 123,
    "equity_amount": 123,
    "equity_percent": 123,
    "total_loan_amt": 123,
    "total_loan_balance": 123,
    "total_loan_payment": 123,
    "owner_1_name": "<string>",
    "owner_1_firstname": "<string>",
    "owner_1_lastname": "<string>",
    "owner_2_name": "<string>",
    "owner_2_firstname": "<string>",
    "owner_2_lastname": "<string>",
    "is_corporate_owner": true,
    "out_of_state_owner": true,
    "owner_address_full": "<string>",
    "building_square_feet": 123,
    "total_bedrooms": 123,
    "total_baths": 123,
    "year_built": 123,
    "property_type": "<string>",
    "units_count": 123,
    "stories": "<string>",
    "garage": true,
    "pool": true,
    "lot_acreage": 123,
    "lot_square_feet": 123,
    "legal_description": "<string>",
    "subdivision_name": "<string>",
    "school_district_name": "<string>",
    "zoning": "<string>",
    "flood_zone": "<string>",
    "tax_delinquent": true,
    "tax_amt": 123,
    "assd_total_value": 123,
    "assd_land_value": 123,
    "assd_improvement_value": 123,
    "calculated_total_value": 123,
    "calculated_land_value": 123,
    "calculated_improvement_value": 123,
    "sale_date": "2023-12-25",
    "last_sale_price": 123,
    "active_lien": true,
    "hoa_fee_amount": 123,
    "h_o_a1_name": "<string>",
    "num_mortgages": 123,
    "mortgages": [
      {
        "position": 2,
        "lien_position": 123,
        "loan_type": "<string>",
        "financing_type": "<string>",
        "interest_rate": 123,
        "has_adjustable_rate_rider": true,
        "start_date": "2023-12-25",
        "recording_date": "2023-12-25",
        "term_months": 123,
        "due_date": "2023-12-25",
        "lender_name": "<string>",
        "is_private_lender": true,
        "loan_amount": 123,
        "estimated_loan_balance": 123,
        "estimated_loan_payment": 123
      }
    ],
    "auction_date": "2023-12-25",
    "default_date": "2023-12-25",
    "property_flags": [
      "<string>"
    ],
    "contacts": [
      {
        "person_id": 123,
        "first_name": "<string>",
        "middle_initial": "<string>",
        "last_name": "<string>",
        "mailing_address": "<string>",
        "mailing_city": "<string>",
        "mailing_state": "<string>",
        "mailing_zip": "<string>",
        "type": [
          "owner",
          "resident"
        ],
        "phones": [
          {
            "number": "<string>",
            "do_not_call": true
          }
        ],
        "emails": [
          "jsmith@example.com"
        ]
      }
    ]
  },
  "usage": {
    "current": 123,
    "limit": 123,
    "warning": "<string>"
  }
}

Property Lookup

Look up property details and owner contact information by providing a street address.

This endpoint requires an API key. See Authentication for details.

Request

You can provide the address in two ways: Option 1: Single-line address

address

string

Full address as a single line (e.g., “123 Main St, Austin, TX 78701”). If provided, the individual street, city, state, and zip fields are ignored.

Option 2: Separate fields

street

string

Street address including house number (e.g., “123 Main St”). Required if address is not provided.

city

string

City name. At least one of city, state, or zip is required when using separate fields.

state

string

Two-letter state abbreviation (e.g., “TX”). At least one of city, state, or zip is required when using separate fields.

zip

string

ZIP code. At least one of city, state, or zip is required when using separate fields.

Response

success

boolean

Whether the request was successful

data

object

Property and owner data

Show Property Identification

property_id

integer

Internal property identifier

apn_parcel_id

string

Assessor Parcel Number

fips_code

string

Federal Information Processing Standards county code

Show Property Address

property_address_full

string

Full formatted address

property_address_line_1

string

Primary street address

property_address_line_2

string

Secondary address line (unit, apt, etc.)

property_address_city

string

City

property_address_state

string

State abbreviation

property_address_zipcode

string

ZIP code

property_address_county

integer

County identifier

property_lat

number

Latitude coordinate

property_lng

number

Longitude coordinate

Show Valuation & Equity

estimated_value

integer

Estimated market value

equity_amount

integer

Estimated equity in dollars

equity_percent

number

Estimated equity as percentage

total_loan_amt

integer

Total estimated loan amount

total_loan_balance

integer

Total estimated loan balance

total_loan_payment

number

Total estimated monthly loan payment

Show Owner Names (from deed)

owner_1_name

string

Primary owner’s full name

owner_1_firstname

string

Primary owner’s first name

owner_1_lastname

string

Primary owner’s last name

owner_2_name

string

Secondary owner’s full name

owner_2_firstname

string

Secondary owner’s first name

owner_2_lastname

string

Secondary owner’s last name

owner_location

string

Owner occupancy status: owner_occupied or absentee

is_corporate_owner

boolean

Owned by a corporation

out_of_state_owner

boolean

Owner lives in different state

owner_address_full

string

Owner’s full mailing address

Show Building Characteristics

building_square_feet

integer

Living area in square feet

total_bedrooms

integer

Number of bedrooms

total_baths

number

Number of bathrooms

year_built

integer

Year the property was built

property_type

string

Property type name. Possible values: Single Family, Townhouse, Condominium, Mobile Home, Multi Family, Vacant Land, Co-Op, Apartment, Other, Office, Retail, Industrial, Hospitality, Healthcare, Mixed Use, Special Purpose, Government / Institutional, Agriculture, Development Site

construction_type

string

Construction type

style

string

Architectural style

effective_year_built

integer

Effective year built (after renovations)

units_count

integer

Number of units (for multi-family)

sum_buildings_nbr

integer

Number of buildings on property

sum_commercial_units

integer

Number of commercial units

stories

string

Number of stories (e.g., “1 Story”, “2 Story”, “Split Level”)

sum_garage_sq_ft

integer

Garage area in square feet

heating_type

string

Heating system type

heating_fuel_type

string

Heating fuel type

air_conditioning

string

Air conditioning type

basement

string

Basement description

deck

string

Deck description

exterior_walls

string

Exterior wall material

interior_walls

string

Interior wall material

num_of_fireplaces

integer

Number of fireplaces

floor_cover

string

Floor covering type

garage

boolean

Has garage

driveway

string

Driveway description

other_rooms

string

Other rooms description

pool

boolean

Has pool

patio

string

Patio description

porch

string

Porch description

roof_cover

string

Roof cover type

roof_type

string

Roof type

sewer

string

Sewer type

topography

string

Land topography

water

string

Water source

geographic_features

string

Geographic features

Show Lot Information

lot_acreage

number

Lot size in acres

lot_square_feet

integer

Lot size in square feet

lot_nbr

string

Lot number

lot_code

string

Lot code

lot_width

number

Lot width

lot_depth

number

Lot depth

corner_lot

boolean

Is corner lot

legal_description

string

Legal description

subdivision_name

string

Subdivision name

property_class

string

Property class

county_land_use_code

string

County land use code

situs_census_tract

string

Census tract

school_district_name

string

School district name

zoning

string

Zoning designation

flood_zone

string

Flood zone name (FEMA flood zone classification, e.g., “Zone X”, “Zone AE”, “Zone VE”)

Show Tax Information

tax_delinquent

boolean

Has delinquent taxes

tax_delinquent_year

integer

Year of tax delinquency

tax_year

integer

Tax assessment year

tax_amt

number

Annual property tax amount

Show Assessment Values

assd_year

integer

Assessment year

assd_total_value

integer

Total assessed value

assd_land_value

integer

Assessed land value

assd_improvement_value

integer

Assessed improvement value

calculated_total_value

integer

Calculated market total value

calculated_land_value

integer

Calculated market land value

calculated_improvement_value

integer

Calculated market improvement value

Show Sale History

sale_date

string

Date of last sale (YYYY-MM-DD)

last_sale_price

integer

Last recorded sale price

last_sale_doc_type

string

Sale document type

building_condition

string

Building condition at sale

building_quality

string

Building quality rating

Show Liens & HOA

active_lien

boolean

Has active liens

hoa_fee_amount

number

HOA fee amount

h_o_a1_name

string

HOA name

h_o_a1_type

string

HOA type

Show Mortgage Information

num_mortgages

integer

Number of mortgages on the property (0-4)

mortgages

array

Array of mortgage objects (up to 4 mortgages)

Show Mortgage Object

position

integer

Mortgage position (1 = first/primary mortgage, 2 = second, etc.)

lien_position

integer

Lien seniority position (1 = senior lien, 2 = junior, etc.)

loan_type

string

Loan type name (e.g., “Conventional”, “FHA”, “VA”, “USDA”)

financing_type

string

Financing type name (e.g., “Fixed Rate”, “Adjustable Rate”, “Interest Only”)

interest_rate

number

Interest rate as a percentage

has_adjustable_rate_rider

boolean

Whether the mortgage has an adjustable rate rider

start_date

string

Mortgage origination date (YYYY-MM-DD)

recording_date

string

Date the mortgage was recorded with the county (YYYY-MM-DD)

term_months

integer

Loan term in months

due_date

string

Mortgage maturity date (YYYY-MM-DD)

lender_name

string

Name of the lending institution

is_private_lender

boolean

Whether the lender is a private (non-institutional) lender

loan_amount

integer

Original loan amount

estimated_loan_balance

integer

Estimated current loan balance

estimated_loan_payment

number

Estimated monthly loan payment

Show Foreclosure Information

auction_date

string

Foreclosure auction date

default_date

string

Default date

past_due_amount

integer

Past due amount

recording_date

string

Recording date

document_type

string

Foreclosure document type

Show Market Status

market_status

string

Current market status: active, pending, foreclosure, preforeclosure, or off_market

property_flags

array

Array of distress indicator slugs. Possible values: vacant, bank_owned, tax_delinquent, preforeclosure, foreclosure, probate, active_lien, corporate_owned, out_of_state_owner

Show Contacts

contacts

array

Array of property contacts (owners, residents, etc.)

Show Contact Object

person_id

integer

Contact person identifier

first_name

string

Contact’s first name

middle_initial

string

Contact’s middle initial

last_name

string

Contact’s last name

mailing_address

string

Contact’s mailing address

mailing_city

string

Contact’s mailing city

mailing_state

string

Contact’s mailing state

mailing_zip

string

Contact’s mailing ZIP code

type

array

Contact’s relationship to property. Array of strings: owner, owner_family, resident, renter

phones

array

Array of phone objects

Show Phone Object

number

string

Phone number in E.164 format (+1XXXXXXXXXX)

type

string

Phone type: mobile, landline, voip, or unknown

do_not_call

boolean

Whether phone is on Do Not Call list

emails

array

Array of email addresses (strings)

usage

object

Included when approaching monthly limit (90%+ usage)

current

integer

Current usage count for billing period

limit

integer

Monthly request limit

warning

string

Warning message about approaching limit

Examples

Separate Fields (Recommended)

curl -X POST https://next.v3.dealmachine.com/api/property/lookup \
  -H "Content-Type: application/json" \
  -H "X-API-Key: dm_live_your_api_key_here" \
  -d '{
    "street": "123 Main St",
    "city": "Austin",
    "state": "TX",
    "zip": "78701"
  }'

Single-Line Address

curl -X POST https://next.v3.dealmachine.com/api/property/lookup \
  -H "Content-Type: application/json" \
  -H "X-API-Key: dm_live_your_api_key_here" \
  -d '{
    "address": "123 Main St, Austin, TX 78701"
  }'

Success Response

{
  "success": true,
  "data": {
    "property_id": 12345678,
    "apn_parcel_id": "123-456-789",
    "fips_code": "48453",
    "property_address_full": "123 Main St, Austin, TX 78701",
    "property_address_line_1": "123 Main St",
    "property_address_line_2": null,
    "property_address_city": "Austin",
    "property_address_state": "TX",
    "property_address_zipcode": "78701",
    "property_address_county": 453,
    "property_lat": 30.2672,
    "property_lng": -97.7431,
    "estimated_value": 425000,
    "equity_amount": 278375,
    "equity_percent": 65.5,
    "total_loan_amt": 146625,
    "total_loan_balance": 146625,
    "total_loan_payment": 1125.50,
    "owner_1_name": "John Smith",
    "owner_1_firstname": "John",
    "owner_1_lastname": "Smith",
    "owner_2_name": null,
    "owner_2_firstname": null,
    "owner_2_lastname": null,
    "owner_location": "absentee",
    "is_corporate_owner": false,
    "out_of_state_owner": false,
    "owner_address_full": "456 Oak Ave, Houston, TX 77001",
    "building_square_feet": 1850,
    "total_bedrooms": 3,
    "total_baths": 2,
    "year_built": 1995,
    "property_type": "Single Family Residential",
    "units_count": 1,
    "stories": "1 Story",
    "garage": true,
    "pool": false,
    "lot_acreage": 0.25,
    "lot_square_feet": 10890,
    "tax_delinquent": false,
    "tax_amt": 8500,
    "assd_total_value": 380000,
    "sale_date": "2018-06-15",
    "last_sale_price": 310000,
    "active_lien": false,
    "num_mortgages": 1,
    "mortgages": [
      {
        "position": 1,
        "lien_position": 1,
        "loan_type": "Conventional",
        "financing_type": "Fixed Rate",
        "interest_rate": 3.75,
        "has_adjustable_rate_rider": false,
        "start_date": "2018-06-15",
        "recording_date": "2018-06-18",
        "term_months": 360,
        "due_date": "2048-06-15",
        "lender_name": "Wells Fargo Bank",
        "is_private_lender": false,
        "loan_amount": 248000,
        "estimated_loan_balance": 198500,
        "estimated_loan_payment": 1148.53
      }
    ],
    "market_status": "off_market",
    "property_flags": [],
    "contacts": [
      {
        "person_id": 98765432,
        "first_name": "John",
        "middle_initial": "A",
        "last_name": "Smith",
        "mailing_address": "456 Oak Ave",
        "mailing_city": "Houston",
        "mailing_state": "TX",
        "mailing_zip": "77001",
        "type": ["owner", "resident"],
        "phones": [
          {
            "number": "+15125551234",
            "type": "mobile",
            "do_not_call": false
          }
        ],
        "emails": ["john.smith@email.com"]
      }
    ]
  }
}

Error Responses

Missing Street Address (400)

{
  "success": false,
  "error": "Bad Request",
  "message": "Street address is required"
}

Property Not Found (404)

{
  "success": false,
  "error": "Not Found",
  "message": "Property not found"
}

Rate Limit Exceeded (429)

{
  "success": false,
  "error": "Too Many Requests",
  "message": "Monthly request limit exceeded. Your limit resets on 2024-02-15.",
  "usage": {
    "current": 5001,
    "limit": 5000,
    "reset": "2024-02-15"
  }
}

Response Headers

All successful responses include rate limit headers:

Header	Description
`X-RateLimit-Limit`	Your monthly request limit
`X-RateLimit-Remaining`	Requests remaining this billing period
`X-RateLimit-Reset`	Date your limit resets (YYYY-MM-DD)
`X-RateLimit-Warning`	Present with value `true` when at 90%+ usage

Authorizations

X-API-Key

string

header

required

API key for authentication (format: dm_live_xxxxxxxx)

Body

application/json

address

string

Full address as a single line. If provided, street/city/state/zip fields are ignored.

Example:

"123 Main St, Austin, TX 78701"

street

string

Street address including house number. Required if 'address' is not provided.

Example:

"123 Main St"

city

string

City name

Example:

"Austin"

state

string

Two-letter state abbreviation

Required string length: 2

Example:

"TX"

zip

string

ZIP code

Example:

"78701"

Response

Successful property lookup

success

boolean

Example:

true

data

object

Show child attributes

usage

object

Included when at 90%+ of monthly limit

Show child attributes

Authentication

⌘I

Documentation Index

​Property Lookup

​Request

​Response

​Examples

​Separate Fields (Recommended)

​Single-Line Address

​Success Response

​Error Responses

​Response Headers

Authorizations

Body

Response

Property Lookup

Request

Response

Examples

Separate Fields (Recommended)

Single-Line Address

Success Response

Error Responses

Response Headers