curl --request POST \
  --url https://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>"
  }
}

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

{
  "success": false,
  "error": "Unauthorized",
  "message": "X-API-Key header is required"
}

{
  "success": false,
  "error": "Subscription Required",
  "message": "No active subscription found"
}

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

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

{
  "success": false,
  "error": "<string>",
  "message": "<string>"
}

POST

api

property

lookup

curl --request POST \
  --url https://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>"
  }
}

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

{
  "success": false,
  "error": "Unauthorized",
  "message": "X-API-Key header is required"
}

{
  "success": false,
  "error": "Subscription Required",
  "message": "No active subscription found"
}

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

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

{
  "success": false,
  "error": "<string>",
  "message": "<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

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

string

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

string

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

string

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

string

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

Response

boolean

Whether the request was successful

object

Property and owner data

Show Property Identification

integer

Internal property identifier

string

Assessor Parcel Number

string

Federal Information Processing Standards county code

Show Property Address

string

Full formatted address

string

Primary street address

string

Secondary address line (unit, apt, etc.)

string

City

string

State abbreviation

string

ZIP code

integer

County identifier

number

Latitude coordinate

number

Longitude coordinate

Show Valuation & Equity

integer

Estimated market value

integer

Estimated equity in dollars

number

Estimated equity as percentage

integer

Total estimated loan amount

integer

Total estimated loan balance

number

Total estimated monthly loan payment

Show Owner Names (from deed)

string

Primary owner’s full name

string

Primary owner’s first name

string

Primary owner’s last name

string

Secondary owner’s full name

string

Secondary owner’s first name

string

Secondary owner’s last name

string

Owner occupancy status: owner_occupied or absentee

boolean

Owned by a corporation

boolean

Owner lives in different state

string

Owner’s full mailing address

Show Building Characteristics

integer

Living area in square feet

integer

Number of bedrooms

number

Number of bathrooms

integer

Year the property was built

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

string

Construction type

string

Architectural style

integer

Effective year built (after renovations)

integer

Number of units (for multi-family)

integer

Number of buildings on property

integer

Number of commercial units

string

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

integer

Garage area in square feet

string

Heating system type

string

Heating fuel type

string

Air conditioning type

string

Basement description

string

Deck description

string

Exterior wall material

string

Interior wall material

integer

Number of fireplaces

string

Floor covering type

boolean

Has garage

string

Driveway description

string

Other rooms description

boolean

Has pool

string

Patio description

string

Porch description

string

Roof cover type

string

Roof type

string

Sewer type

string

Land topography

string

Water source

string

Geographic features

Show Lot Information

number

Lot size in acres

integer

Lot size in square feet

string

Lot number

string

Lot code

number

Lot width

number

Lot depth

boolean

Is corner lot

string

Legal description

string

Subdivision name

string

Property class

string

County land use code

string

Census tract

string

School district name

string

Zoning designation

string

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

Show Tax Information

boolean

Has delinquent taxes

integer

Year of tax delinquency

integer

Tax assessment year

number

Annual property tax amount

Show Assessment Values

integer

Assessment year

integer

Total assessed value

integer

Assessed land value

integer

Assessed improvement value

integer

Calculated market total value

integer

Calculated market land value

integer

Calculated market improvement value

Show Sale History

string

Date of last sale (YYYY-MM-DD)

integer

Last recorded sale price

string

Sale document type

string

Building condition at sale

string

Building quality rating

Show Liens & HOA

boolean

Has active liens

number

HOA fee amount

string

HOA name

string

HOA type

Show Mortgage Information

integer

Number of mortgages on the property (0-4)

array

Array of mortgage objects (up to 4 mortgages)

Show Mortgage Object

integer

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

integer

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

string

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

string

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

number

Interest rate as a percentage

boolean

Whether the mortgage has an adjustable rate rider

string

Mortgage origination date (YYYY-MM-DD)

string

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

integer

Loan term in months

string

Mortgage maturity date (YYYY-MM-DD)

string

Name of the lending institution

boolean

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

integer

Original loan amount

integer

Estimated current loan balance

number

Estimated monthly loan payment

Show Foreclosure Information

string

Foreclosure auction date

string

Default date

integer

Past due amount

string

Recording date

string

Foreclosure document type

Show Market Status

string

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

array

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

Show Contacts

array

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

Show Contact Object

integer

Contact person identifier

string

Contact’s first name

string

Contact’s middle initial

string

Contact’s last name

string

Contact’s mailing address

string

Contact’s mailing city

string

Contact’s mailing state

string

Contact’s mailing ZIP code

array

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

array

Array of phone objects

Show Phone Object

string

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

string

Phone type: mobile, landline, voip, or unknown

boolean

Whether phone is on Do Not Call list

array

Array of email addresses (strings)

object

Included when approaching monthly limit (90%+ usage)

integer

Current usage count for billing period

integer

Monthly request limit

string

Warning message about approaching limit

Examples

Separate Fields (Recommended)

curl -X POST https://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"
  }'

const response = await fetch('https://dealmachine.com/api/property/lookup', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'dm_live_your_api_key_here'
  },
  body: JSON.stringify({
    street: '123 Main St',
    city: 'Austin',
    state: 'TX',
    zip: '78701'
  })
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://dealmachine.com/api/property/lookup',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'dm_live_your_api_key_here'
    },
    json={
        'street': '123 Main St',
        'city': 'Austin',
        'state': 'TX',
        'zip': '78701'
    }
)

data = response.json()
print(data)

Single-Line Address

curl -X POST https://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"
  }'

const response = await fetch('https://dealmachine.com/api/property/lookup', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'dm_live_your_api_key_here'
  },
  body: JSON.stringify({
    address: '123 Main St, Austin, TX 78701'
  })
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://dealmachine.com/api/property/lookup',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'dm_live_your_api_key_here'
    },
    json={
        'address': '123 Main St, Austin, TX 78701'
    }
)

data = response.json()
print(data)

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

Overview

Property Enrichment

Property Lookup

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

Authorizations

Body

Response

Property Lookup

Request

Response

Examples

Separate Fields (Recommended)

Single-Line Address

Success Response

Error Responses

Response Headers