Skip to content
  • Lookup Property

    Use Lookup Property endpoint to get general information regarding properties.

    Lookup information on a property

    Request

    The LookupProperty endpoint returns general information regarding a property.

    The service requires at least one of the following input combinations:

    Set A - addresskey

    Set B - fips, apn

    Set C - fips, account

    Set D - mak

    Set E - ff

    Set F - a1, postal

    Set G - a1, city, state

    Query
    colsstring

    Columns - The column names or groups to be output.

    Entering the column name will return the column. Specifying a group name will return all columns in the group.

    Delimit multiple columns with a ,.

    For example: ColumnName,ColumnName.

    Columns:

    GrpAll - Recommended. Indicates to the Cloud API that all fields should be returned.

    GrpParcel - Parcel info
    • AccountNumber
    • AlternateAPN
    • APNYearChange (Deprecated)
    • County
    • FIPSCode
    • FormattedAPN
    • MapBook
    • MapPage
    • MinorCivilDivisionName
    • PreviousAPN
    • UnformattedAPN
    • YearAdded (Deprecated)
    GrpLegal - Legal description info
    • Block1
    • Block2 (Deprecated)
    • LegalDescription
    • LotNumber1
    • LotNumber2
    • LotNumber3
    • Phase
    • Quarter
    • QuarterQuarter
    • Range
    • Section
    • Subdivision
    • Township
    • TractNumber
    • Unit
    GrpPropertyAddress - Address of the property
    • Address
    • AddressKey
    • BaseMAK
    • CarrierRoute
    • City
    • Latitude
    • Longitude
    • MAK
    • PrivacyInfo
    • State
    • Zip
    GrpParsedPropertyAddress - Parsed elements of the property address
    • PostDirectional
    • PreDirectional
    • Range
    • StreetName
    • Suffix
    • SuiteName
    • SuiteRange
    GrpPrimaryOwner - Primary owner info
    • CompanyFlag
    • MelissaIdentityKey1
    • MelissaIdentityKey2
    • Name1First
    • Name1Full
    • Name1Last
    • Name1Middle
    • Name1Suffix
    • Name2First
    • Name2Full
    • Name2Last
    • Name2Middle
    • Name2Suffix
    • TrustFlag
    • Type (Deprecated)
    • VestingType
    GrpSecondaryOwner(Deprecated) - Secondary owner info
    • Name3First (Deprecated)
    • Name3Full (Deprecated)
    • Name3Last (Deprecated)
    • Name3Middle (Deprecated)
    • Name3Suffix (Deprecated)
    • Name4First (Deprecated)
    • Name4Full (Deprecated)
    • Name4Last (Deprecated)
    • Name4Middle (Deprecated)
    • Name4Suffix (Deprecated)
    • Type (Deprecated)
    GrpOwnerAddress - Owner's address info
    • Address
    • BaseMAK
    • CarrierRoute
    • City
    • FormatInfo
    • MAK
    • PrivacyInfo
    • State
    • Zip
    GrpLastDeedOwnerInfo - Owner info listed on latest deed for the property
    • Name1First
    • Name1Full
    • Name1Last
    • Name1Middle
    • Name1Suffix
    • Name2First
    • Name2Full
    • Name2Last
    • Name2Middle
    • Name2Suffix
    • Name3First (Deprecated)
    • Name3Full (Deprecated)
    • Name3Last (Deprecated)
    • Name3Middle (Deprecated)
    • Name3Suffix (Deprecated)
    • Name4First (Deprecated)
    • Name4Full (Deprecated)
    • Name4Last (Deprecated)
    • Name4Middle (Deprecated)
    • Name4Suffix (Deprecated)
    GrpCurrentDeed - Other deed info listed on the latest deed for the property
    • LenderCode (Deprecated)
    • LenderName
    • MortgageAmount
    • MortgageDate
    • MortgageDueDate
    • MortgageLoanTypeCode
    • MortgageTerm
    • MortgageTermCode
    • SecondMortgageAmount
    • SecondMortgageLoanTypeCode
    GrpTax - Property tax info
    • AssessedImprovementsPerc
    • AssessedValueImprovements
    • AssessedValueLand
    • AssessedValueTotal
    • AssrLastUpdated
    • LastTaxRollUpdate
    • MarketImprovementsPerc
    • MarketValueImprovements
    • MarketValueLand
    • MarketValueTotal
    • MarketValueYear
    • PreviousAssessedValue (Deprecated)
    • PropertyUseGroup
    • PropertyUseMuni
    • PropertyUseStandardized
    • TaxBilledAmount
    • TaxDelinquentYear
    • TaxExemptionAdditional
    • TaxExemptionDisabled
    • TaxExemptionHomeowner
    • TaxExemptionSenior
    • TaxExemptionVeteran
    • TaxExemptionWidow
    • TaxFiscalYear
    • TaxRateArea
    • YearAssessed
    • YearBuilt
    • YearBuiltEffective
    • ZonedCodeLocal
    GrpPropertyUseInfo - Property usage info
    • PropertyUseGroup
    • PropertyUseMuni
    • PropertyUseStandardized
    • YearBuilt
    • YearBuiltEffective
    • ZonedCodeLocal
    GrpSaleInfo - Property sale info
    • AssessorLastSaleAmount
    • AssessorLastSaleDate
    • AssessorPriorSaleAmount
    • AssessorPriorSaleDate
    • DeedLastDocumentNumber
    • DeedLastSaleDate
    • DeedLastSaleDocumentBook
    • DeedLastSaleDocumentPage
    • DeedLastSalePrice
    • DeedLastSaleTxID (Deprecated)
    • LastOwnershipTransferDate
    • LastOwnershipTransferDocumentNumber
    • LastOwnershipTransferTxID (Deprecated)
    GrpPropertySize - Property size info
    • Area1stFloor
    • Area2ndFloor
    • AreaBuilding
    • AreaBuildingDefinitionCode
    • AreaGross
    • AreaLotAcres
    • AreaLotSF
    • AreaUpperFloors
    • AtticArea
    • AtticFlag
    • BasementArea
    • BasementAreaFinished
    • BasementAreaUnfinished
    • LotDepth
    • LotWidth
    • ParkingCarport
    • ParkingCarportArea
    • ParkingGarage
    • ParkingGarageArea
    GrpPool - Pool info
    • Pool
    • PoolArea
    • SaunaFlag
    GrpIntStructInfo - Interior structural info
    • Construction
    • ConstructionFireResistanceClass
    • FlooringMaterialPrimary
    • Foundation
    • InteriorStructure
    • PlumbingFixturesCount
    • SafetyFireSprinklersFlag
    GrpIntRoomInfo - Interior rooms info
    • BathCount
    • BathPartialCount
    • BedroomsCount
    • BonusRoomFlag
    • BreakfastNookFlag
    • CellarFlag
    • CellarWineFlag (Deprecated)
    • ExcerciseFlag
    • FamilyCode
    • GameFlag
    • GreatFlag
    • HobbyFlag
    • LaundryFlag
    • MediaFlag
    • MudFlag
    • OfficeArea
    • OfficeFlag
    • RoomsCount
    • SafeRoomFlag
    • SittingFlag
    • StoriesCount
    • StormFlag
    • StudyFlag
    • SunroomFlag
    • UnitsCount
    • UtilityArea
    • UtilityCode
    GrpIntAmenities - Interior amenities info
    • AccessabilityElevatorFlag
    • AccessabilityHandicapFlag
    • CentralVacuumFlag
    • EscalatorFlag
    • Fireplace
    • FireplaceCount
    • IntercomFlag
    • SecurityAlarmFlag
    • SoundSystemFlag
    • WetBarFlag
    GrpExtStructInfo - Exterior structural info
    • Exterior1Code
    • OverheadDoorFlag
    • RoofConstruction
    • RoofMaterial
    • StormShutterFlag
    • StructureStyle
    GrpExtAmenities - Exterior amenities info
    • BalconyArea
    • BreezewayFlag
    • DeckArea
    • DeckFlag
    • FeatureBalconyFlag
    • PatioArea
    • PorchArea
    • PorchCode
    • ViewDescription
    GrpExtBuildings - Exterior building info
    • BathHouseArea
    • BathHouseFlag
    • BoatAccessFlag (Deprecated)
    • BoatHouseArea
    • BoatHouseFlag
    • BuildingsCount
    • CabinArea
    • CabinFlag
    • CanopyArea
    • CanopyFlag
    • GazeboArea
    • GazeboFlag
    • GranaryArea
    • GranaryFlag
    • GreenHouseArea
    • GreenHouseFlag
    • GuestHouseArea
    • GuestHouseFlag
    • KennelArea
    • KennelFlag
    • LeanToArea
    • LeanToFlag
    • LoadingPlatformArea
    • LoadingPlatformFlag
    • MilkHouseArea
    • MilkHouseFlag
    • OutdoorKitchenFireplaceFlag
    • PoleStructureArea
    • PoleStructureFlag
    • PoolHouseArea
    • PoolHouseFlag
    • PoultryHouseArea
    • PoultryHouseFlag
    • QuonsetArea
    • QuonsetFlag
    • ShedArea
    • ShedCode
    • SiloArea
    • SiloFlag
    • StableArea
    • StableFlag
    • StorageBuildingArea
    • StorageBuildingFlag
    • UtilityBuildingArea
    • UtilityBuildingFlag
    GrpUtilities - Utility info
    • HVACCoolingDetail
    • HVACHeatingDetail
    • HVACHeatingFuel
    • MobileHomeHookupFlag
    • SewageUsage
    • WaterSource
    GrpParking - Parking info
    • DrivewayArea
    • DrivewayMaterial
    • ParkingSpaceCount
    • RVParkingFlag
    GrpYardGardenInfo - Yard & garden info
    • ArborPergolaFlag
    • ArenaFlag
    • BoatLiftFlag
    • CourtyardArea
    • CourtyardFlag
    • FenceArea
    • FenceCode
    • GolfCourseGreenFlag
    • PondFlag
    • SportsCourtFlag
    • SprinklersFlag
    • TennisCourtFlag
    • TopographyCode
    • WaterFeatureFlag
    GrpEstimatedValue - Calculated estimated value of the property
    • ConfidenceScore
    • EstimatedMaxValue
    • EstimatedMinValue
    • EstimatedValue
    • ValuationDate
    GrpShape - Parcel geometry shape in well known text format
    • WellKnownText
    idany, (password)required

    Required. The License Key issued by Melissa.

    Example:id={REPLACE-WITH-YOUR-LICENSE-KEY}
    formatstring

    Desired format of the response.

    Enum:"json""xml"
    Example:format=JSON
    optstring

    Options - Specify which options to use. List options in <OptionName>:<Parameter> format. Multiple options are delimited with a ,.

    For example: OptionName:Parameter,OptionName:Parameter.

    • Desc:< off | on > - Default set to off. This options allows Property to return back human readable descriptions and meanings instead of codes.
    • LatestMortgage:< Off | On > - Default set to Off. This options allows Property to have the CurrentDeed structure represent the latest mortgage, if available.
    tstring

    Transmission Reference - This is a string value that serves as a unique identifier for this set of records. It is returned as sent.

    Example:t=Test
    a1stringrequired

    Input field for address line 1. This should contain the delivery address information (house number, street, building, suite, etc.) but should not contain locality information (city, state, postal code, etc.) which have their own inputs.

    Example:a1=710 Winston Ln
    a2string

    Input field for address line 2. This can be a continuation of AddressLine1 (ex: suite) or another address.

    addresskeystring, = 11 characters

    An 11-digit key of the property. Based on the Zip5, Plus4 and two digit delivery code.

    apnstring

    Assessor's Parcel Number (APN) for the property.

    citystringrequired

    The city for the property.

    Example:city=Sugar Land
    ctrystring

    The country for the property. Currently only properties in the US can be looked up.

    ffstring

    Free form address for the property.

    fipsstring

    Federal Information Processing Standard (FIPS) code for the property.

    makstring

    A proprietary unique key identifier for an address derived from Address Checking.

    postalstring

    The postal code for the property.

    statestringrequired

    The US state for the property.

    Example:state=TX
    Headers
    Acceptstringrequired

    Format of the response.

    Enum:"application/json""application/xml""*/*"
    Example:*/*
    Content-Typestringrequired

    Format of the request.

    Enum:"application/json""application/xml"
    GET
    /LookupProperty
    curl -i -X GET \
      'https://property.melissadata.net/v4/WEB/LookupProperty?id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D&a1=710%20Winston%20Ln&city=Sugar%20Land&state=TX' \
      -H 'Accept: */*' \
      -H 'Content-Type: application/json'

    Responses

    Successful response

    Body
    Versionstring

    The current service version number.

    TransmissionReferencestring

    Serves as a unique request identifier.

    TransmissionResultsstring

    Lists error codes from any errors caused by the most recent request as a whole. For more information, see Property Result Codes.

    TotalRecordsinteger

    Total number of records.

    RecordsArray of objects

    The returned array of records.

    Response
    { "Version": "9.4.2.1107", "TransmissionReference": "Test", "TransmissionResults": "", "TotalRecords": 1, "Records": [ {} ] }