> ## Documentation Index
> Fetch the complete documentation index at: https://enrich-docs.dealmachine.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Property Lookup
> Look up property details and owner contact information by address
# Property Lookup
Look up property details and owner contact information by providing a street address.
This endpoint requires an API key. See [Authentication](/api-reference/authentication) for details.
## Request
You can provide the address in two ways:
**Option 1: Single-line address**
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 address including house number (e.g., "123 Main St"). Required if `address` is not provided.
City name. At least one of `city`, `state`, or `zip` is required when using separate fields.
Two-letter state abbreviation (e.g., "TX"). At least one of `city`, `state`, or `zip` is required when using separate fields.
ZIP code. At least one of `city`, `state`, or `zip` is required when using separate fields.
## Response
Whether the request was successful
Property and owner data
Internal property identifier
Assessor Parcel Number
Federal Information Processing Standards county code
Full formatted address
Primary street address
Secondary address line (unit, apt, etc.)
City
State abbreviation
ZIP code
County identifier
Latitude coordinate
Longitude coordinate
Estimated market value
Estimated equity in dollars
Estimated equity as percentage
Total estimated loan amount
Total estimated loan balance
Total estimated monthly loan payment
Primary owner's full name
Primary owner's first name
Primary owner's last name
Secondary owner's full name
Secondary owner's first name
Secondary owner's last name
Owner occupancy status: `owner_occupied` or `absentee`
Owned by a corporation
Owner lives in different state
Owner's full mailing address
Living area in square feet
Number of bedrooms
Number of bathrooms
Year the property was built
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
Architectural style
Effective year built (after renovations)
Number of units (for multi-family)
Number of buildings on property
Number of commercial units
Number of stories (e.g., "1 Story", "2 Story", "Split Level")
Garage area in square feet
Heating system type
Heating fuel type
Air conditioning type
Basement description
Deck description
Exterior wall material
Interior wall material
Number of fireplaces
Floor covering type
Has garage
Driveway description
Other rooms description
Has pool
Patio description
Porch description
Roof cover type
Roof type
Sewer type
Land topography
Water source
Geographic features
Lot size in acres
Lot size in square feet
Lot number
Lot code
Lot width
Lot depth
Is corner lot
Legal description
Subdivision name
Property class
County land use code
Census tract
School district name
Zoning designation
Flood zone name (FEMA flood zone classification, e.g., "Zone X", "Zone AE", "Zone VE")
Has delinquent taxes
Year of tax delinquency
Tax assessment year
Annual property tax amount
Assessment year
Total assessed value
Assessed land value
Assessed improvement value
Calculated market total value
Calculated market land value
Calculated market improvement value
Date of last sale (YYYY-MM-DD)
Last recorded sale price
Sale document type
Building condition at sale
Building quality rating
Has active liens
HOA fee amount
HOA name
HOA type
Number of mortgages on the property (0-4)
Array of mortgage objects (up to 4 mortgages)
Mortgage position (1 = first/primary mortgage, 2 = second, etc.)
Lien seniority position (1 = senior lien, 2 = junior, etc.)
Loan type name (e.g., "Conventional", "FHA", "VA", "USDA")
Financing type name (e.g., "Fixed Rate", "Adjustable Rate", "Interest Only")
Interest rate as a percentage
Whether the mortgage has an adjustable rate rider
Mortgage origination date (YYYY-MM-DD)
Date the mortgage was recorded with the county (YYYY-MM-DD)
Loan term in months
Mortgage maturity date (YYYY-MM-DD)
Name of the lending institution
Whether the lender is a private (non-institutional) lender
Original loan amount
Estimated current loan balance
Estimated monthly loan payment
Foreclosure auction date
Default date
Past due amount
Recording date
Foreclosure document type
Current market status: `active`, `pending`, `foreclosure`, `preforeclosure`, or `off_market`
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`
Array of property contacts (owners, residents, etc.)
Contact person identifier
Contact's first name
Contact's middle initial
Contact's last name
Contact's mailing address
Contact's mailing city
Contact's mailing state
Contact's mailing ZIP code
Contact's relationship to property. Array of strings: `owner`, `owner_family`, `resident`, `renter`
Array of phone objects
Phone number in E.164 format (+1XXXXXXXXXX)
Phone type: `mobile`, `landline`, `voip`, or `unknown`
Whether phone is on Do Not Call list
Array of email addresses (strings)
Included when approaching monthly limit (90%+ usage)
Current usage count for billing period
Monthly request limit
Warning message about approaching limit
## Examples
### Separate Fields (Recommended)
```bash cURL theme={null}
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"
}'
```
```javascript JavaScript theme={null}
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);
```
```python Python theme={null}
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
```bash cURL theme={null}
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"
}'
```
```javascript JavaScript theme={null}
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);
```
```python Python theme={null}
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
```json theme={null}
{
"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)**
```json theme={null}
{
"success": false,
"error": "Bad Request",
"message": "Street address is required"
}
```
**Property Not Found (404)**
```json theme={null}
{
"success": false,
"error": "Not Found",
"message": "Property not found"
}
```
**Rate Limit Exceeded (429)**
```json theme={null}
{
"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 |
## OpenAPI
````yaml POST /api/property/lookup
openapi: 3.0.3
info:
title: DealMachine Property Enrichment API
description: Property and owner data lookup API for CRM integrations
version: 1.0.0
contact:
name: DealMachine Support
email: support@dealmachine.com
url: https://dealmachine.com
servers:
- url: https://dealmachine.com
description: Production
- url: https://www.dealmachine.com
description: WWW production alias
- url: https://next.dealmachine.com
description: Legacy production alias
- url: https://next.v3.dealmachine.com
description: Legacy API alias
security:
- ApiKeyAuth: []
paths:
/api/property/lookup:
post:
tags:
- Property Enrichment
summary: Property Lookup
description: Look up property details and owner contact information by address
operationId: propertyLookup
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PropertyLookupRequest'
examples:
separate-fields:
summary: Separate address fields (recommended)
value:
street: 123 Main St
city: Austin
state: TX
zip: '78701'
single-line:
summary: Single-line address
value:
address: 123 Main St, Austin, TX 78701
responses:
'200':
description: Successful property lookup
headers:
X-RateLimit-Limit:
description: Monthly request limit
schema:
type: integer
X-RateLimit-Remaining:
description: Requests remaining in billing period
schema:
type: integer
X-RateLimit-Reset:
description: Date limit resets (YYYY-MM-DD)
schema:
type: string
format: date
content:
application/json:
schema:
$ref: '#/components/schemas/PropertyLookupResponse'
'400':
description: Bad request - missing or invalid parameters
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error: Bad Request
message: Street address is required
'401':
description: Unauthorized - invalid or missing API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error: Unauthorized
message: X-API-Key header is required
'403':
description: Forbidden - subscription required or inactive
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error: Subscription Required
message: No active subscription found
'404':
description: Property not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error: Not Found
message: Property not found
'429':
description: Rate limit exceeded
headers:
Retry-After:
description: Seconds until limit resets
schema:
type: integer
X-RateLimit-Limit:
schema:
type: integer
X-RateLimit-Reset:
schema:
type: string
format: date
content:
application/json:
schema:
$ref: '#/components/schemas/RateLimitErrorResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
PropertyLookupRequest:
type: object
properties:
address:
type: string
description: >-
Full address as a single line. If provided, street/city/state/zip
fields are ignored.
example: 123 Main St, Austin, TX 78701
street:
type: string
description: >-
Street address including house number. Required if 'address' is not
provided.
example: 123 Main St
city:
type: string
description: City name
example: Austin
state:
type: string
description: Two-letter state abbreviation
example: TX
minLength: 2
maxLength: 2
zip:
type: string
description: ZIP code
example: '78701'
PropertyLookupResponse:
type: object
properties:
success:
type: boolean
example: true
data:
$ref: '#/components/schemas/PropertyData'
usage:
$ref: '#/components/schemas/UsageInfo'
ErrorResponse:
type: object
properties:
success:
type: boolean
example: false
error:
type: string
message:
type: string
RateLimitErrorResponse:
type: object
properties:
success:
type: boolean
example: false
error:
type: string
example: Too Many Requests
message:
type: string
example: Monthly request limit exceeded. Your limit resets on 2024-02-15.
usage:
type: object
properties:
current:
type: integer
limit:
type: integer
reset:
type: string
format: date
PropertyData:
type: object
properties:
property_id:
type: integer
description: Internal property identifier
apn_parcel_id:
type: string
nullable: true
description: Assessor Parcel Number
fips_code:
type: string
nullable: true
description: County FIPS code
property_address_full:
type: string
description: Full formatted property address
property_address_line_1:
type: string
property_address_line_2:
type: string
nullable: true
property_address_city:
type: string
property_address_state:
type: string
description: Two-letter state abbreviation
property_address_zipcode:
type: string
property_address_county:
type: integer
nullable: true
property_lat:
type: number
format: double
property_lng:
type: number
format: double
estimated_value:
type: integer
nullable: true
description: Estimated market value
equity_amount:
type: integer
nullable: true
description: Estimated equity in dollars
equity_percent:
type: number
nullable: true
description: Estimated equity percentage
total_loan_amt:
type: integer
nullable: true
total_loan_balance:
type: integer
nullable: true
total_loan_payment:
type: number
nullable: true
description: Total estimated monthly loan payment
owner_1_name:
type: string
nullable: true
description: Primary owner full name (from deed)
owner_1_firstname:
type: string
nullable: true
owner_1_lastname:
type: string
nullable: true
owner_2_name:
type: string
nullable: true
description: Secondary owner full name
owner_2_firstname:
type: string
nullable: true
owner_2_lastname:
type: string
nullable: true
owner_location:
type: string
enum:
- owner_occupied
- absentee
description: Whether owner lives at property
is_corporate_owner:
type: boolean
out_of_state_owner:
type: boolean
owner_address_full:
type: string
nullable: true
description: Owner mailing address
building_square_feet:
type: integer
nullable: true
total_bedrooms:
type: integer
nullable: true
total_baths:
type: number
nullable: true
year_built:
type: integer
nullable: true
property_type:
type: string
nullable: true
description: >-
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
units_count:
type: integer
nullable: true
stories:
type: string
nullable: true
description: Number of stories (e.g., 1 Story, 2 Story, Split Level)
garage:
type: boolean
nullable: true
pool:
type: boolean
nullable: true
lot_acreage:
type: number
nullable: true
lot_square_feet:
type: integer
nullable: true
legal_description:
type: string
nullable: true
subdivision_name:
type: string
nullable: true
school_district_name:
type: string
nullable: true
zoning:
type: string
nullable: true
flood_zone:
type: string
nullable: true
description: FEMA flood zone classification (e.g., Zone X, Zone AE, Zone VE)
tax_delinquent:
type: boolean
tax_amt:
type: integer
nullable: true
description: Annual property tax
assd_total_value:
type: integer
nullable: true
assd_land_value:
type: integer
nullable: true
assd_improvement_value:
type: integer
nullable: true
calculated_total_value:
type: integer
nullable: true
description: Market total value
calculated_land_value:
type: integer
nullable: true
calculated_improvement_value:
type: integer
nullable: true
sale_date:
type: string
format: date
nullable: true
last_sale_price:
type: integer
nullable: true
active_lien:
type: boolean
hoa_fee_amount:
type: number
nullable: true
h_o_a1_name:
type: string
nullable: true
num_mortgages:
type: integer
nullable: true
description: Number of mortgages on the property (0-4)
mortgages:
type: array
description: Array of mortgage objects (up to 4 mortgages)
items:
$ref: '#/components/schemas/Mortgage'
auction_date:
type: string
format: date
nullable: true
description: Foreclosure auction date
default_date:
type: string
format: date
nullable: true
description: Foreclosure default date
market_status:
type: string
enum:
- active
- pending
- foreclosure
- preforeclosure
- off_market
description: Current listing status
property_flags:
type: array
items:
type: string
description: >-
Distress indicator slugs. Possible values: vacant, bank_owned,
tax_delinquent, preforeclosure, foreclosure, probate, active_lien,
corporate_owned, out_of_state_owner
contacts:
type: array
description: Property contacts (owners, residents, etc.)
items:
$ref: '#/components/schemas/Contact'
UsageInfo:
type: object
description: Included when at 90%+ of monthly limit
properties:
current:
type: integer
limit:
type: integer
warning:
type: string
Mortgage:
type: object
description: Mortgage information for a property
properties:
position:
type: integer
description: Mortgage position (1 = first/primary, 2 = second, etc.)
minimum: 1
maximum: 4
lien_position:
type: integer
nullable: true
description: Lien seniority position (1 = senior lien, 2 = junior, etc.)
loan_type:
type: string
nullable: true
description: Loan type name (e.g., Conventional, FHA, VA, USDA)
financing_type:
type: string
nullable: true
description: Financing type name (e.g., Fixed Rate, Adjustable Rate)
interest_rate:
type: number
nullable: true
description: Interest rate as a percentage
has_adjustable_rate_rider:
type: boolean
nullable: true
description: Whether the mortgage has an adjustable rate rider
start_date:
type: string
format: date
nullable: true
description: Mortgage origination date
recording_date:
type: string
format: date
nullable: true
description: Date the mortgage was recorded with the county
term_months:
type: integer
nullable: true
description: Loan term in months
due_date:
type: string
format: date
nullable: true
description: Mortgage maturity date
lender_name:
type: string
nullable: true
description: Name of the lending institution
is_private_lender:
type: boolean
nullable: true
description: Whether the lender is a private (non-institutional) lender
loan_amount:
type: integer
nullable: true
description: Original loan amount
estimated_loan_balance:
type: integer
nullable: true
description: Estimated current loan balance
estimated_loan_payment:
type: number
nullable: true
description: Estimated monthly loan payment
Contact:
type: object
properties:
person_id:
type: integer
nullable: true
first_name:
type: string
nullable: true
middle_initial:
type: string
nullable: true
last_name:
type: string
nullable: true
mailing_address:
type: string
nullable: true
mailing_city:
type: string
nullable: true
mailing_state:
type: string
nullable: true
mailing_zip:
type: string
nullable: true
type:
type: array
description: Contact's relationship to property
items:
type: string
enum:
- owner
- owner_family
- resident
- renter
example:
- owner
- resident
phones:
type: array
items:
$ref: '#/components/schemas/Phone'
emails:
type: array
items:
type: string
format: email
Phone:
type: object
properties:
number:
type: string
description: E.164 format (+1XXXXXXXXXX)
type:
type: string
enum:
- mobile
- landline
- voip
- unknown
nullable: true
do_not_call:
type: boolean
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: 'API key for authentication (format: dm_live_xxxxxxxx)'
````