Retrieves all the data required to build a homeowner dashboard, including property summary and home equity summary. If a user owns multiple properties it will return a summary for each.

Endpoint

GET https://api.chimney.io/retrieve-owner-data

Parameters

  • userID (required): The unique identifier of the user.

Response

The API response will include the following information:

  • Property Summary: Detailed information about the property owned by the user.
  • Home Value Summary: Summary of home value, equity, and loan information.

Example Request

GET /retrieve-owner-data?userID=141297406

Response

The API will respond with a JSON object containing the property summary and home equity summary data.

Below are example responses for each section.

Example Property Summary Response

{
  "propertySummary": {
    "identifier": {
			"userId": 141297406,
      "propertyId": 141297406,
      "fips": "12103",
      "apn": "15-28-16-36292-000-5060"
    },
    "lot": {
      "depth": 100,
      "frontage": 65,
      "lotnum": "506",
      "lotsize1": 0.1494031,
      "lotsize2": 6508,
      "poolind": "YES"
    },
    "area": {
      "loctype": "VIEW - NONE",
      "countrysecsubd": "Pinellas",
      "countyuse1": "00110",
      "muncode": "PI",
      "munname": "PINELLAS",
      "srvyRange": "16",
      "srvySection": "15",
      "srvyTownship": "28",
      "subdname": "HARBOR PALMS UNIT ELEVEN",
      "taxcodearea": "OM"
    },
    "address": {
      "country": "US",
      "countrySubd": "FL",
      "line1": "409 EVERGREEN DR",
      "line2": "OLDSMAR, FL 34677",
      "locality": "OLDSMAR",
      "matchCode": "ExaStr",
      "oneLine": "409 EVERGREEN DR, OLDSMAR, FL 34677",
      "postal1": "34677",
      "postal2": "2603",
      "postal3": "R008"
    },
    "location": {
      "accuracy": "Rooftop",
      "latitude": "28.046212",
      "longitude": "-82.693545",
      "distance": 0,
      "geoid": "CO12103, CS1293380, DB1201560, PL1251350, RS0005091602, SB0000079367, SB0000079399, SB0000079416, ZI34677",
      "geoIdV4": {
        "CO": "0f129821f85a773b9e6d67a221e1c0d7",
        "CS": "7a361dd4c08bd227730b595820619577",
        "DB": "70c8102a5ea623a2d880811940154ee7",
        "PL": "f3d316b427b0ec2a7c5835695156ed50",
        "SB": "db0e75fef802989f2631bf4922e5f137,064987d2897ee35f2165e83eca0ee71f,6e0f11f6d7c7bd478fa9a0dc24c6c0f9",
        "Z

I": "03c1d4e5b15038c701d5ab103fce54cf"
      }
    },
    "propertyType": {
      "absenteeInd": "ABSENTEE(MAIL AND SITUS NOT =)",
      "propclass": "Single Family Residence / Townhouse",
      "propsubtype": "Residential",
      "proptype": "SFR",
      "yearbuilt": 1980
    },
    "utilities": {
      "coolingtype": "CENTRAL",
      "heatingtype": "FORCED AIR"
    },
    "building": {
      "size": {
        "bldgsize": 1388,
        "grosssize": 1844,
        "grosssizeadjusted": 1388,
        "groundfloorsize": 1388,
        "livingsize": 1388,
        "sizeInd": "LIVING SQFT",
        "universalsize": 1388
      },
      "rooms": {
        "bathfixtures": 6,
        "bathsfull": 2,
        "bathstotal": 2
      },
      "interior": {
        "floors": "CONCRETE/CEMENT",
        "fplccount": 1,
        "fplcind": "Y",
        "fplctype": "YES"
      },
      "construction": {
        "constructiontype": "CONCRETE BLOCK",
        "foundationtype": "CONTINUOUS FOOTING",
        "frameType": "PRE FAB",
        "roofcover": "SHINGLE",
        "roofShape": "GABLE/HIP",
        "wallType": "STUCCO"
      },
      "parking": {
        "prkgSize": 308,
        "prkgSpaces": "1"
      },
      "summary": {
        "bldgsNum": 1,
        "bldgType": "CONVENTIONAL HOUSE",
        "imprType": "HOUSE",
        "levels": 1,
        "quality": "AVERAGE",
        "storyDesc": "CONVENTIONAL HOUSE",
        "view": "VIEW - NONE",
        "viewCode": "000",
        "yearbuilteffective": 1997
      }
    },
    "vintage": {
      "lastModified": "2023-02-13",
      "pubDate": "2023-02-13"
    },
    "chimneyEstimate": {
      "eventDate": "2023-04-25",
      "amount": {
        "scr": 98,
        "value": 418831,
        "high": 427207,
        "low": 410454,
        "valueRange": 8376
      },
      "chimneyEstimateChange": {
        "lastmonthvalue": 442750,
        "amountchange": -23919,
        "percentchange": -0.05
      },
      "calculations": {
        "perSizeUnit": 301,
        "ratioTaxAmt": 97.41,
        "ratioTaxValue": 1,
        "rangePctOfValue": 4
      },
      "condition": {
        "avmpoorlow": 389931.3,
        "avmpoorhigh": 405846.65,
        "avmgoodlow": 410454,
        "avmgoodhigh": 427207,
        "avmexcellentlow": 420715.35,
        "avmexcellenthigh": 437887.18
      }
    },
    "sale

": {
      "salesearchdate": "2004-11-30",
      "amount": {
        "saleamt": 159000,
        "salerecdate": "2004-11-30",
        "saledisclosuretype": 0,
        "saledoctype": "DEED",
        "saledocnum": "0139680121",
        "saletranstype": "Resale"
      },
      "calculation": {
        "pricepersizeunit": 114.55
      },
      "interfamily": "N",
      "resaleornewconstruction": "M",
      "cashormortgagepurchase": "M"
    },
    "assessment": {
      "appraised": {},
      "assessed": {
        "assdttlpersizeunit": 188.34,
        "assdttlvalue": 261419
      },
      "calculations": {
        "calcimprind": "ASSESSED VALUE",
        "calclandind": "ASSESSED VALUE",
        "calcttlind": "ASSESSED VALUE",
        "calcttlvalue": 261419,
        "calcvaluepersizeunit": 188.34
      },
      "market": {
        "mktimprvalue": 133865,
        "mktlandvalue": 127554,
        "mktttlvalue": 261419
      },
      "tax": {
        "taxamt": 4299.53,
        "taxpersizeunit": 3.1,
        "taxyear": 2022
      }
    }
  }
}

Example Equity Summary Response

{
  "Home Value Summary": {
    "chimneyEstimate": "1000000",
    "high": "1500000",
    "low": "900000"
  },
  "availableEquity": "120000",
  "totalEquity": "250000",
  "LTV": "0.52",
  "availableEquityRange": {
    "high": "150000",
    "low": "100000"
  },
  "totalLoanBalance": "130000",
  "totalLoanCount": 2
}

Loan Summary --

{
  "primaryMortgage": {
    "exists": true,
    "balance": "80000",
    "ID": "123456"
  },
  "secondHomeLoan": {
    "exists": true,
    "balance": "50000",
    "ID": "789012"
  },
  "thirdHomeLoan": {
    "exists": false,
    "balance": null,
    "ID": null
  }
}