Skip to main content

​
Overview

ATTOM Data Solutions exposes a single attom automation type that fans out to every endpoint across the Property, Sale, Assessment, AVM, Valuation, Sales Comparables, All Events, Area, Community, POI, School, and DLP product families. Call any action with automationType: "attom", an action name, and a params body.

​
Authentication

  • ATTOM API Key — pass it as params.apiKey on every request.

​
Identifier schemes

Most property-level actions accept a universal identifier set. Provide exactly one of the following schemes; paired schemes require both fields together.
  • attomid — ATTOM property ID (most precise; you’ll typically obtain it from a prior property_id or property_address lookup).
  • address — full single-line address (e.g. "5500 Grand Lake Dr, San Antonio, TX, 78244").
  • address1 + address2 — paired (street on line 1, “City, State, Zip” on line 2).
  • fips + apn — paired (FIPS county code + assessor parcel number).
  • latitude + longitude — paired (decimal degrees).
Partial pairs (e.g. only address1 without address2) are rejected by the validator. The handler additionally enforces that at least one scheme is supplied. A few endpoints have their own identifier rules (called out per-action):
  • avmhistory_detail — same as universal except no single-line address.
  • salescomparables_* — DLP v2 endpoints that take URL path segments (street/city/state/zip, apn/county/state, or attomid).
  • preforeclosure_details — accepts AttomID, OR apn+county+state (triple), OR combinedAddress.
  • Area / Community / School / POI — geographic identifiers (geoIdv4, geoIdV4, lat/lon + radius, etc.).

​
Available Actions

Property Sale & Sales History Assessment AVM (Automated Valuation Model) Valuation Sales Comparables (DLP v2) All Events Enumerations School Specialty Area API Community API POI (Points of Interest) Deprecated legacy aliases — kept for backward compatibility, each forwards to a canonical action:

​
Examples

​
Example 1: Property ID

Look up a property using any identifier scheme. Often used as the first call to obtain attomid for downstream actions. 
{
  "automationType": "attom",
  "nodeId": "example-node-001",
  "nodeParams": {
    "action": "property_id",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 2: Property Address

Address lookup returning core property fields. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "property_address",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address": "5500 Grand Lake Dr, San Antonio, TX, 78244"
    }
  }
}

​
Example 3: Property Snapshot

Summary property snapshot. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "property_snapshot",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 4: Property Detail

Detailed property characteristics — identifier, lot, area, address, location, summary, utilities, building. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "property_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address": "5500 Grand Lake Dr, San Antonio, TX, 78244"
    }
  }
}

​
Example 5: Property Basic Profile

Basic property info plus the most recent transaction and taxes. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "property_basicprofile",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 6: Property Expanded Profile

Detailed property info plus most recent transaction, assessment, mortgage, and owner data. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "property_expandedprofile",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 7: Property Detail with Schools

Property detail plus schools within the attendance boundary. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "property_detailwithschools",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 8: Property Detail Mortgage

Property detail with mortgage information (lender, loan amount, type, term, due date). 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "property_detailmortgage",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 9: Property Detail Owner

Property detail with owner names, mailing address, and absentee-owner status. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "property_detailowner",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 10: Property Detail Mortgage Owner

Property detail combined with both mortgage and owner information. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "property_detailmortgageowner",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 11: Property Building Permits

Building permit history for a property. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "property_buildingpermits",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 12: Sale Detail

Detailed information about a property’s most recent sale (amount, date, type, buyer/seller, price calcs). 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "sale_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 13: Sale Snapshot

Summary of the most recent sale. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "sale_snapshot",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 14: Sales History Detail

Sales history with transfer details. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "saleshistory_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 15: Sales History Snapshot

Summary sales history. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "saleshistory_snapshot",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 16: Sales History Basic

Basic chronological list of sales, mortgages, and transfers with buyer/seller and mortgage details. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "saleshistory_basichistory",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 17: Sales History Expanded

Detailed transaction, pre-foreclosure, and loan history with title company, deed types, and full mortgage detail. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "saleshistory_expandedhistory",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 18: Assessment Detail

Detailed assessment data including tax amounts. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "assessment_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 19: Assessment Snapshot

Summary assessment data. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "assessment_snapshot",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 20: Assessment History Detail

Historical assessment records for a property. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "assessmenthistory_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 21: AVM Detail

Legacy AVM endpoint with value estimates and ranges. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "avm_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 22: AVM Snapshot

Summary AVM. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "avm_snapshot",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 23: Attomized AVM Detail

Canonical AVM endpoint — market values, value range, and confidence scores. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "attomavm_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 24: AVM History Detail

Historical AVM valuations. Identifier rules differ slightly: no single-line address — use attomid, address1+address2, or fips+apn. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "avmhistory_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 25: Valuation Home Equity

Direct home equity estimate. Typically requires the Home Equity add-on tier on the ATTOM contract. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "valuation_homeequity",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 26: Valuation Rental AVM

Automated valuation model for rental properties. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "valuation_rentalavm",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 27: Sales Comparables by Address

DLP v2 endpoint — identifiers passed as URL path segments. Use "-" for unknown county. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "salescomparables_address",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "street": "222 sirius ave",
      "city": "anaheim",
      "county": "-",
      "state": "ca",
      "zip": "92802"
    }
  }
}

​
Example 28: Sales Comparables by APN

{
  "automationType": "attom",
  "nodeParams": {
    "action": "salescomparables_apn",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "apn": "127-471-49",
      "county": "orange",
      "state": "ca"
    }
  }
}

​
Example 29: Sales Comparables by Property ID

{
  "automationType": "attom",
  "nodeParams": {
    "action": "salescomparables_propid",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 30: All Events Detail

Combined timeline of assessments, AVM updates, and sales for a property. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "allevents_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 31: All Events Snapshot

Summary of all property events. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "allevents_snapshot",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "attomid": "2509607"
    }
  }
}

​
Example 32: Enumerations Detail

Returns enumerated values used elsewhere in the API. Omit fieldnames to retrieve the full set. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "enumerations_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "fieldnames": "PropertyType,DeedType"
    }
  }
}
Search for schools by latitude + longitude + radius, OR by geoIdv4. Lat/lon must be paired. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "school_search",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "latitude": "29.4719",
      "longitude": "-98.5247",
      "radius": "5"
    }
  }
}

​
Example 34: School Profile

Detailed profile for a single school by geoIdv4. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "school_profile",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "geoIdv4": "9c1d09c5e1a9b8a6f3e7c0d4b2a1e8f9"
    }
  }
}

​
Example 35: School District

Detailed profile for a school district by geoIdv4. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "school_district",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "geoIdv4": "0a2b1c4d3e5f6789a0b1c2d3e4f56789"
    }
  }
}

​
Example 36: Transportation Noise

Transportation noise data for a property. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "transportation_noise",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address": "5500 Grand Lake Dr, San Antonio, TX, 78244"
    }
  }
}

​
Example 37: Sales Trend

Two years of average / median sale prices and counts within a geographic area. Common interval values: monthly, quarterly, yearly. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "salestrend",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "geoIdv4": "31bd5b21fc8f1aa1f7a35936a7ce4d5e",
      "interval": "yearly",
      "startyear": "2022",
      "endyear": "2024"
    }
  }
}

​
Example 38: Preforeclosure Details

Pre-foreclosure detail. Provide exactly one of: AttomID, apn+county+state (all three required together), or combinedAddress. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "preforeclosure_details",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "combinedAddress": "5709 W NANCY ST, SIOUX FALLS, SD 57106"
    }
  }
}

​
Example 39: Area Boundary Detail

Boundary data for an area by geoIdV4 or areaId. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "area_boundary_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "geoIdV4": "31bd5b21fc8f1aa1f7a35936a7ce4d5e",
      "format": "geojson"
    }
  }
}

​
Example 40: Area Hierarchy Lookup

Area hierarchy lookup by latitude+longitude (paired) or by wktstring + geoType. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "area_hierarchy_lookup",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "latitude": "29.4719",
      "longitude": "-98.5247"
    }
  }
}

​
Example 41: Area State Lookup

State-level area lookup. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "area_state_lookup",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "stateId": "TX"
    }
  }
}

​
Example 42: Area County Lookup

County lookup within a state. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "area_county_lookup",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "stateId": "TX"
    }
  }
}

​
Example 43: Area CBSA Lookup

Metropolitan Statistical Area lookup. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "area_cbsa_lookup",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "stateId": "TX"
    }
  }
}

​
Example 44: Area GeoID Lookup

GeoID lookup with type. Common geoType codes: ND (neighborhood), ZI (zip), CO (county). 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "area_geoid_lookup",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "geoIdV4": "31bd5b21fc8f1aa1f7a35936a7ce4d5e",
      "geoType": "ZI"
    }
  }
}

​
Example 45: Area GeoID Legacy Lookup

Convert a legacy geoId to a v4 identifier. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "area_geoid_legacy_lookup",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "geoId": "ZI78244"
    }
  }
}

​
Example 46: Area Location Lookup

/v4/location/lookup — find a location by name and geographic type. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "area_location_lookup",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "name": "San Antonio",
      "geographyTypeAbbreviation": "CO"
    }
  }
}

​
Example 47: Community Neighborhood

Community / demographic profile by neighborhood geoIdv4. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "community_neighborhood",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "geoIdv4": "9c1d09c5e1a9b8a6f3e7c0d4b2a1e8f9"
    }
  }
}

​
Example 48: Community Location Lookup

Community-context wrapper around /v4/location/lookup. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "community_location_lookup",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "name": "San Antonio",
      "geographyTypeAbbreviation": "CO"
    }
  }
}

​
Example 49: POI Search by Point

Points of interest search by WKT POINT. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "poi_search_by_point",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "point": "POINT(-98.5247 29.4719)",
      "radius": "1",
      "categoryName": "RESTAURANT"
    }
  }
}

​
Example 50: POI Search by Address

Points of interest search by address. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "poi_search_by_address",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address": "5500 Grand Lake Dr, San Antonio, TX, 78244",
      "radius": "1"
    }
  }
}

​
Example 51: POI Category Lookup

Look up POI categories, lines of business, and industries. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "poi_category_lookup",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "category": "RESTAURANT"
    }
  }
}

​
Example 52: School Detail (legacy)

Deprecated — forwards to school_profile. Kept for backward compatibility with the legacy school_detail action. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "school_detail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "geoIdv4": "9c1d09c5e1a9b8a6f3e7c0d4b2a1e8f9"
    }
  }
}

​
Example 53: School District Detail (legacy)

Deprecated — forwards to school_district. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "school_districtdetail",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "geoIdv4": "0a2b1c4d3e5f6789a0b1c2d3e4f56789"
    }
  }
}

​
Example 54: Foreclosure by Address (legacy)

Deprecated — forwards to preforeclosure_details (combinedAddress form). 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "foreclosure_by_address",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "combinedAddress": "5709 W NANCY ST, SIOUX FALLS, SD 57106"
    }
  }
}

​
Example 55: Foreclosure Details (legacy)

Deprecated — forwards to preforeclosure_details. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "foreclosure_details",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "combinedAddress": "5709 W NANCY ST, SIOUX FALLS, SD 57106"
    }
  }
}

​
Example 56: Property History (legacy)

Deprecated — forwards to allevents_detail. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "property_history",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 57: Mortgage Details (legacy)

Deprecated — forwards to allevents_detail. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "mortgage_details",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address1": "5500 Grand Lake Dr",
      "address2": "San Antonio, TX, 78244"
    }
  }
}

​
Example 58: Neighborhood Market Data (legacy)

Deprecated — forwards to salestrend. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "neighborhood_market_data",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "geoIdv4": "31bd5b21fc8f1aa1f7a35936a7ce4d5e",
      "interval": "yearly"
    }
  }
}

​
Example 59: Market Statistics (legacy)

Deprecated — forwards to salestrend. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "market_statistics",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "geoIdv4": "31bd5b21fc8f1aa1f7a35936a7ce4d5e",
      "interval": "monthly"
    }
  }
}

​
Example 60: Environmental Data (legacy)

Deprecated — forwards to transportation_noise. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "environmental_data",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address": "5500 Grand Lake Dr, San Antonio, TX, 78244"
    }
  }
}

​
Example 61: Hazard Data (legacy)

Deprecated — forwards to transportation_noise. 
{
  "automationType": "attom",
  "nodeParams": {
    "action": "hazard_data",
    "params": {
      "apiKey": "YOUR_ATTOM_API_KEY",
      "address": "5500 Grand Lake Dr, San Antonio, TX, 78244"
    }
  }
}

​
Third-Party Documentation

  • ATTOM Developer Portal: https://api.developer.attomdata.com/
  • ATTOM API specs (OpenAPI / Swagger): browse the developer portal under each product family (Property, Sale, Assessment, AVM, Valuation, DLP v2/v3, Area, Community, POI, School).