Address Lookup

Description

This endpoint allows you to search for properties by address.

Details

---
url: https://properties-api.inveloapp.com/properties/address-lookup
method: POST
---

Request Schema

{
  "addresses": [
    {
      "identifier": "", // optional
      "addressStreet": "999 Canterbury DR", // required
      "addressState": "MA", // required
      "addressCity": "LUNENBURG", // one of addressCity or addressZip is required
      "addressZip": "01462",
      "addressUnitType": "APT", // optional if present on address
      "addressUnitNumber": "5430" // optional if present on address
    },
    // ... up to 100 addresses at once
  ]
}

Parameter	Required	Data Type	Description
addresses[].identifier	no	string	identifier for your use. Allows you to identify the response property with the requested address.
addresses[].addressStreet	yes	string	Full street address excluding the unit type and unit number.
addresses[].addressState	yes	string	Two letter acronym state value.
addresses[].addressCity	no	string	Address city. Either city or zip is required.
addresses[].addressZip	no	string	5 digit zip code. Either city or zip is required.
addresses[].addressUnitType	no	string	Unit Type if present on address. (Ex: "APT")
addresses[].addressUnitNumber	no	string	Unit Number if present on address excluding the unit type. (Ex: "A" if "APT A")

Example Response

{
    "addresses": [
        {
            "identifier": "my-identifier",
            "properties": [
                {
                    "propertyId": "66924100",
                    "fullStreetAddress": "999 Burrage St",
                    "unit": null,
                    "unitType": null,
                    "city": "Lunenburg",
                    "state": "MA",
                    "zipCode": "01462",
                    "latitude": 44.999999,
                    "longitude": -44.999999,
                    "ownerIsCompany": false,
                    "owner1FullName": "Int Cumming",
                    "owner1LastName": "Int",
                    "owner1FirstName": "Cumming",
                    "owner1MiddleName": null,
                    "owner1Suffix": null,
                    "owner2FullName": null,
                    "owner2LastName": null,
                    "owner2FirstName": null,
                    "owner2MiddleName": null,
                    "owner2Suffix": null,
                    "mailingFullStreetAddress": "999 Burrage St",
                    "mailingUnitType": null,
                    "mailingUnitNumber": null,
                    "mailingCity": "Lunenburg",
                    "mailingZipCode": "01462",
                    "mailingState": "MA",
                    "mailingCoName": null,
                    "mailingIsForeign": false,
                    "apn": "LUNE M:108.0 B:0008 L:0000.0",
                    "county": "Worcester County",
                    "ownerOccupiedStatus": "Owner-occupied",
                    "buildingCondition": "Average",
                    "bathrooms": 2.5,
                    "bedrooms": 4,
                    "totalRooms": 8,
                    "units": null,
                    "stories": 2,
                    "yearBuilt": 1995,
                    "taxDelinquencyYear": null,
                    "livingAreaSqft": 2095,
                    "buildingAreaSqft": 2095,
                    "basementAreaSqft": 1164,
                    "garageAreaSqft": null,
                    "lotAreaSqft": 317097,
                    "lengthOfResidence": "10+ years",
                    "vacancyDate": null,
                    "isVacant": null,
                    "assessedTotalValue": 488500,
                    "assessedLandValue": 154100,
                    "assessedImprovedValue": 334400,
                    "lastSaleDate": "1995-04-12",
                    "lastSalePrice": "52500",
                    "estimatedValue": 608045,
                    "estimatedEquity": 74.23,
                    "estimatedEquityValue": 451351,
                    "estimatedDebt": 25.77,
                    "estimatedDebtValue": 156693,
                    "listingStatus": null,
                    "propertyType": "RESIDENTIAL: SFR",
                    "propertyTypeCode": "1001",
                    "streetAddress": "999 Burrage St"
                }
            ]
        },
        /// ... up to 100 addresses at once
    ]
}

Notes

• You may provide up to 100 addresses per request
• You might not have access to all fields depending on your API subscription level
• Not all fields might be present for a property
• There may be multiple properties returned for a single address