--- title: "Lookup deeds for properties" method: POST path: "/LookupDeeds" tags: ["Lookup Deeds"] --- # Lookup deeds for properties `POST /LookupDeeds` Submit a batch request to receive an array of deeds and/or transactions from the recorder table when given the Property MAK or the FIPs and APN. The following are the possible minimum input requirements: - `FIPS` and `APN` - `PropertyMAK` - `FreeForm` ## Headers - `Accept` 'application/json' | 'application/xml' | '*/*', required - `Content-Type` 'application/json' | 'application/xml', required ## Request body - RequestLookupDeeds - `Columns` string — [Columns](https://docs.melissa.com/cloud-api/property/property-reference-guide.html#property-referenceguide-lookupdeeds-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.
GrpDocInfo - Deed document information - `Book` - `InstrumentDate` - `InstrumentNumber` - `NumberFormatted` *(Deprecated)* - `NumberLegacy` *(Deprecated)* - `Page` - `RecordingDate` - `TypeCode`
GrpTxDefInfo - Deed transaction details & info - `ArmsLengthFlag` - `ForeclosureAuctionSale` - `PartialInterest` - `QuitclaimFlag` - `TransactionType` - `TransferInfoDistressCircumstanceCode`*(Deprecated)* - `TransferInfoMultiParcelFlag` - `TransferInfoPurchaseTypeCode` *(Deprecated)*
GrpTxAmtInfo - Deed transaction amount info - `TransferAmount` - `TransferAmountInfoAccuracy` - `TransferTaxCounty` *(Deprecated)* - `TransferTaxTotal`
GrpPrimaryGrantor - Primary deed grantor names - `Name1ClassType` *(Deprecated)* - `Name1First` - `Name1Full` - `Name1Last` - `Name1LegalType` *(Deprecated)* - `Name1Middle` - `Name1Suffix` - `Name2ClassType` *(Deprecated)* - `Name2First` - `Name2Full` - `Name2Last` - `Name2LegalType` *(Deprecated)* - `Name2Middle` - `Name2Suffix`
GrpSecondaryGrantor (Deprecated) - Secondary deed grantor names - `Name3ClassType` *(Deprecated)* - `Name3First` *(Deprecated)* - `Name3Full` *(Deprecated)* - `Name3Last` *(Deprecated)* - `Name3Middle` *(Deprecated)* - `Name3Suffix` *(Deprecated)* - `Name4ClassType` *(Deprecated)* - `Name4First` *(Deprecated)* - `Name4Full` *(Deprecated)* - `Name4Last` *(Deprecated)* - `Name4Middle` *(Deprecated)* - `Name4Suffix` *(Deprecated)*
GrpPrimaryGrantee - Primary deed grantee names - `Name1ClassType` - `Name1First` - `Name1Full` - `Name1Last` - `Name1LegalType` - `Name1Middle` - `Name1Suffix` - `Name2ClassType` - `Name2First` - `Name2Full` - `Name2Last` - `Name2Middle` - `Name2Suffix`
GrpSecondaryGrantee (Deprecated) - Secondary deed grantee names - `Name3ClassType` *(Deprecated)* - `Name3First` *(Deprecated)* - `Name3Full` *(Deprecated)* - `Name3Last` *(Deprecated)* - `Name3Middle` *(Deprecated)* - `Name3Suffix` *(Deprecated)* - `Name4ClassType` *(Deprecated)* - `Name4First` *(Deprecated)* - `Name4Full` *(Deprecated)* - `Name4Last` *(Deprecated)* - `Name4Middle` *(Deprecated)* - `Name4Suffix` *(Deprecated)*
GrpTitleCompInfo - Title company info - `StandardizedCode` *(Deprecated)* - `StandardizedName` - `TitleCompanyRaw`
GrpMortgage1 - First mortgage info - `AdjustableRateIndex` - `AdjustableRateRiderFlag` - `Amount` - `Book` - `DocNumberFormatted` - `DocNumberLegacy` *(Deprecated)* - `FixedStepConvRate` *(Deprecated)* - `InstrumentNumber` - `InterestChangeFreq` - `InterestIndex` *(Deprecated)* - `InterestMargin` - `InterestOnlyFlag` - `InterestOnlyPeriod` - `InterestRate` - `InterestRateMax` - `InterestRateType` - `InterestTypeChangeDate` - `InterestTypeInitial` *(Deprecated)* - `IsLenderSeller` - `LenderAddress` *(Deprecated)* - `LenderCity` *(Deprecated)* - `LenderCode` *(Deprecated)* - `LenderFirstName` - `LenderFullName` - `LenderLastName` - `LenderState` *(Deprecated)* - `LenderType` *(Deprecated)* - `LenderZip` *(Deprecated)* - `MaxInterestRateFirstChange` *(Deprecated)* - `MinInterestRateFirstChange` *(Deprecated)* - `Page` - `PrepaymentPenaltyFlag` - `PrepaymentTerm` *(Deprecated)* - `RecordingDate` - `Term` *(Deprecated)* - `TermDate` - `TermType` *(Deprecated)* - `Type`
GrpMortgage2 - Second mortgage info - `AdjustableRateIndex` - `AdjustableRateRiderFlag` - `Amount` - `Book` - `DocNumberFormatted` - `DocNumberLegacy` *(Deprecated)* - `FixedStepConvRate` *(Deprecated)* - `InstrumentNumber` - `InterestChangeFreq` - `InterestIndex` *(Deprecated)* - `InterestMargin` - `InterestOnlyFlag` - `InterestOnlyPeriod` - `InterestRate` - `InterestRateMax` - `InterestRateType` - `InterestTypeChangeDate` - `InterestTypeInitial` *(Deprecated)* - `IsLenderSeller` - `LenderAddress` *(Deprecated)* - `LenderCity` *(Deprecated)* - `LenderCode` *(Deprecated)* - `LenderFirstName` *(Deprecated)* - `LenderFullName` - `LenderLastName` *(Deprecated)* - `LenderState` *(Deprecated)* - `LenderType` *(Deprecated)* - `LenderZip` *(Deprecated)* - `MaxInterestRateFirstChange` *(Deprecated)* - `MinInterestRateFirstChange` *(Deprecated)* - `Page` - `PrepaymentPenaltyFlag` - `PrepaymentTerm` *(Deprecated)* - `RecordingDate` - `Term` *(Deprecated)* - `TermDate` - `TermType` *(Deprecated)* - `Type`
GrpValuation (Deprecated) - Estimated down payment and LTV values - `EstDownPayment` *(Deprecated)* - `EstLTV` *(Deprecated)*
- `CustomerId` string, required — Required. The [License Key](https://docs.melissa.com/melissa/license/license-information.html) issued by Melissa. - `Options` string — [Options](https://docs.melissa.com/cloud-api/property/property-reference-guide.html#property-referenceguide-lookupdeeds-options) - Specify which options to use. List options in `:` format. Multiple options are delimited with a `,`. For example: `OptionName:Parameter,OptionName:Parameter`. - `Page:< Integer >` - Specifies which “page” to return. Acceptable values are any integer. - `RecordsPerPage:< 0 - 100 >` - Default set to `1`. Sets the records per “page”. Acceptable values are `0` to `100`, inclusive. - `TransmissionReference` string — This is a string value that serves as a unique identifier for this set of records. It is returned as sent. - `APN` string — Assessor's Parcel Number (APN) for the property. - `FIPS` string — Federal Information Processing Standard (FIPS) code for the property. - `FreeForm` string — Free form address for the property. - `PropertyMAK` string — A proprietary unique key identifier for an address derived from Address Checking. - `TransactionID` string — Specific transaction ID to specify one deed or transaction. ## Response `200` Successful response - ResponseLookupDeeds - `Version` string — The current service version number. - `TransmissionReference` string — Serves as a unique request identifier. - `Results` string — Lists error codes from any errors caused by the most recent request as a whole. For more information, see [Property Result Codes](https://docs.melissa.com/cloud-api/property/result-codes.html). - `TotalRecords` integer — Total number of records. - `TransactionID` string — A unique string identifier for this record. A unique transaction ID is generated for every record handled. - `Records` LookupDeedsRecords[] - `DocInfo` LookupDeedsDocInfo - `Book` string — The document number book. This can contain either the recorder document book or the legal description book. - `InstrumentDate` string — The execution date with the format: `YYYY-MM-DD`. This pre-dates the RecordingDate and may be the notary date. - `InstrumentNumber` string — If the document is indexed by a recorder's reference number, this will contain that number. Usually the year will not be added to this field unless there is a regional requirement. - `NumberFormatted` string — The document number based on the document book, page, or instrument number. - `NumberLegacy` string — The document number from a previous platform, if different than `NumberFormatted`. - `Page` string — The document number page. This can contain either the recorder document page or the legal description page. - `RecordingDate` string — The official filing date with the format: `YYYY-MM-DD`. This is normally located on the document. - `TypeCode` string — The type of document. E.g. grand deed, quit claim, etc. - `TxDefInfo` LookupDeedsTxDefInfo - `ArmsLengthFlag` string — Specifies the transfer was between two unrelated parties. - `ForeclosureAuctionSale` string — Specifies if the transaction was due to a foreclosure auction. - `PartialInterest` string — Specifies what percentage of the legal ownership was transferred. - `QuitclaimFlag` string — Specifies if the transaction is a Quit claim. - `TransactionType` string — The transaction type. - `TransferInfoDistressCircumstanceCode` string — A distress scenario code. - `TransferInfoMultiParcelFlag` string — Specifies if the transaction has multiple parcels. - `TransferInfoPurchaseTypeCode` string — The type of resale transaction. E.g. construction, subdivision, etc. - `TxAmtInfo` LookupDeedsTxAmtInfo - `TransferAmount` string — The amount, in dollars, of consideration in an ownership changing transaction. - `TransferAmountInfoAccuracy` string — The type of transaction. - `TransferTaxCounty` string — This amount is a rate levied by the state per $1,000 of consideration paid in the transaction. Often this is a transfer tax stamp on the document. This may be the full sales price or only the equity transferred with any new financing, depending on the state. - `TransferTaxTotal` string — The total of the city and county transfer tax amounts. Unique to some regions. - `PrimaryGrantor` LookupDeedsPrimaryGrantor - `Name1ClassType` string — Describes the class of the primary seller based off of the name and vesting. E.g. individual, trust, company. - `Name1First` string — The first name of the primary seller. - `Name1Full` string — The full name of the primary seller. - `Name1Last` string — The last name of the primary seller. - `Name1LegalType` string — The legal ownership type of the primary seller. E.g. married, beneficiary, etc. - `Name1Middle` string — The parsed middle name or initial of the primary seller. - `Name1Suffix` string — The suffix of the primary seller. E.g. Jr, III, etc. - `Name2ClassType` string — Describes the class of the secondary seller based off of the name and vesting. E.g. individual, trust, company. - `Name2First` string — The first name of the secondary seller. - `Name2Full` string — The full name of the secondary seller. - `Name2Last` string — The last name of the secondary seller. - `Name2LegalType` string — The legal ownership type of the secondary seller. E.g. married, beneficiary, etc. - `Name2Middle` string — The parsed middle name or initial of the secondary seller. - `Name2Suffix` string — The suffix of the secondary seller. E.g. Jr, III, etc. - `SecondaryGrantor` LookupDeedsSecondaryGrantor - `Name3ClassType` string — Describes the class of the third seller based off of the name and vesting. E.g. individual, trust, company. - `Name3First` string — The first name of the third seller. - `Name3Full` string — The full name of the third seller. - `Name3Last` string — The last name of the third seller. - `Name3Middle` string — The parsed middle name or initial of the third seller. - `Name3Suffix` string — The suffix of the third seller. E.g. Jr, III, etc. - `Name4ClassType` string — Describes the class of the fourth seller based off of the name and vesting. E.g. individual, trust, company. - `Name4First` string — The first name of the fourth seller. - `Name4Full` string — The full name of the fourth seller. - `Name4Last` string — The last name of the fourth seller. - `Name4Middle` string — The parsed middle name or initial of the fourth seller. - `Name4Suffix` string — The suffix of the fourth seller. E.g. Jr, III, etc. - `PrimaryGrantee` LookupDeedsPrimaryGrantee - `Name1ClassType` string — Describes the class of the primary buyer or borrower based off of the name and vesting. E.g. individual, trust, company. - `Name1First` string — The first name of the primary buyer or borrower. This will be blank if this is not an individual. - `Name1Full` string — The full name of the primary buyer or borrower. - `Name1Last` string — The last name of the primary buyer or borrower. This will be the full name if this is not an individual. - `Name1LegalType` string — The legal ownership type of the primary buyer or borrower. E.g. married, beneficiary, etc. - `Name1Middle` string — The parsed middle name or initial of the primary buyer or borrower. - `Name1Suffix` string — The suffix of the primary buyer or borrower. E.g. Jr, III, etc. - `Name2ClassType` string — Describes the class of the secondary buyer or borrower based off of the name and vesting. E.g. individual, trust, company. - `Name2First` string — The first name of the secondary buyer or borrower. This will be blank if this is not an individual. - `Name2Full` string — The full name of the secondary buyer or borrower. - `Name2Last` string — The last name of the secondary buyer or borrower. This will be the full name if this is not an individual. - `Name2Middle` string — The parsed middle name or initial of the secondary buyer or borrower. - `Name2Suffix` string — The suffix of the secondary buyer or borrower. E.g. Jr, III, etc. - `SecondaryGrantee` LookupDeedsSecondaryGrantee - `Name3ClassType` string — Describes the class of the third buyer or borrower based off of the name and vesting. E.g. individual, trust, company. - `Name3First` string — The first name of the third buyer or borrower. This will be blank if this is not an individual. - `Name3Full` string — The full name of the third buyer or borrower. - `Name3Last` string — The last name of the third buyer or borrower. This will be the full name if this is not an individual. - `Name3Middle` string — The parsed middle name or initial of the third buyer or borrower. - `Name3Suffix` string — The suffix of the third buyer or borrower. E.g. Jr, III, etc. - `Name4ClassType` string — Describes the class of the fourth buyer or borrower based off of the name and vesting. E.g. individual, trust, company. - `Name4First` string — The first name of the fourth buyer or borrower. This will be blank if this is not an individual. - `Name4Full` string — The full name of the fourth buyer or borrower. - `Name4Last` string — The last name of the fourth buyer or borrower. This will be the full name if this is not an individual. - `Name4Middle` string — The parsed middle name or initial of the fourth buyer or borrower. - `Name4Suffix` string — The suffix of the fourth buyer or borrower. E.g. Jr, III, etc. - `TitleCompInfo` LookupDeedsTitleCompInfo - `StandardizedCode` string — The standard code identifying the title company. - `StandardizedName` string — The standardized name of the title company. - `TitleCompanyRaw` string — The entered name of the title company. This is not standardized. - `Mortgage1` LookupDeedsMortgage1 - `AdjustableRateIndex` string — The benchmark interest rate the first mortgage's adjustable rate is based on. - `AdjustableRateRiderFlag` string — Specifies if the property has an adjustable rate mortgage rider, where the loan interest rate will change on a set date. - `Amount` string — The loan amount of the first mortgage. - `Book` string — The first mortgage number book. This can contain either the recorder document book or the legal description book. - `DocNumberFormatted` string — The first mortgage number based on the book, page, or instrument number. - `DocNumberLegacy` string — The first mortgage loan instrument, book, or page number located on the first sequence trust deed. - `FixedStepConvRate` string — The interest rate change in a fixed step conversion mortgage for the first mortgage. - `InstrumentNumber` string — If the first mortgage is indexed by a recorder's reference number, this will contain that number. Usually the year will not be added to this field unless there is a regional requirement. - `InterestChangeFreq` string — The frequency at which interest rates might change. - `InterestIndex` string — The benchmark interest rate the first mortgage’s rate is based on. - `InterestMargin` string — The fixed percentage rate added to an index value to determine the fully indexed interest rate of an adjustable rate mortgage for the first mortgage. - `InterestOnlyFlag` string — Specifies if the first mortgage has an interest only period. - `InterestOnlyPeriod` string — The length of the interest only period, in years. - `InterestRate` string — The interest rate of the first mortgage. - `InterestRateMax` string — The maximum interest rate allowed for the first mortgage, if it is an adjustable rate. - `InterestRateType` string — The interest rate type for the first mortgage. - `InterestTypeChangeDate` string — Specifies what date the loan will convert from a fixed interest rate to an adjustable interest rate in the format: `YY-MM-DD` (2-digit year, e.g. 2030 = “30”) - `InterestTypeInitial` string — The initial type of interest rate on the first mortgage. E.g. fixed or adjustable. - `IsLenderSeller` string — Specifies if the lender is also the seller for the first mortgage. - `LenderAddress` string — The address of the first mortgage lender. - `LenderCity` string — The city of the first mortgage lender. - `LenderCode` string — The standard ID code of the lender for the first mortgage. - `LenderFirstName` string — The first name of the first mortgage lender. This will be the complete name if the lender is a company. - `LenderFullName` string — The full standardized name of the lender for the first mortgage. - `LenderLastName` string — The last name of the first mortgage lender. - `LenderState` string — The state of the first mortgage lender. - `LenderType` string — The lender type for the first mortgage. - `LenderZip` string — The ZIP Code of the first mortgage lender. - `MaxInterestRateFirstChange` string — The maximum interest rate allowed when the loan is switched from a fixed to an adjustable interest rate. - `MinInterestRateFirstChange` string — The minimum interest rate allowed when the loan is switched from a fixed to an adjustable interest rate. - `Page` string — The first mortgage number page. This can contain either the recorder document page or the legal description page. - `PrepaymentPenaltyFlag` string — Specifies if the first mortgage has a pre-payment penalty. - `PrepaymentTerm` string — The number of months the first mortgage must remain active. - `RecordingDate` string — The first mortgage official filing date with the format: `YYYY-MM-DD`. This is normally located on the document. - `Term` string — The duration of the first mortgage. See the associated `TermType` to know the unit of measurement. - `TermDate` string — The due date of the first mortgage. - `TermType` string — The duration unit of measurement (month, year) for the first mortgage. See the associated `Term` to know the duration. - `Type` string — The type of loan for the first mortgage. E.g. conventional, construction, FHA, etc. - `Mortgage2` LookupDeedsMortgage2 - `AdjustableRateIndex` string — The benchmark interest rate the second mortgage's adjustable rate is based on. - `AdjustableRateRiderFlag` string — Specifies if the property has an adjustable rate mortgage rider, where the loan interest rate will change on a set date. - `Amount` string — The loan amount of the second mortgage. - `Book` string — The second mortgage number book. This can contain either the recorder document book or the legal description book. - `DocNumberFormatted` string — The second mortgage number based on the book, page, or instrument number. - `DocNumberLegacy` string — The second mortgage loan instrument, book, or page number located on the first sequence trust deed. - `FixedStepConvRate` string — The interest rate change in a fixed step conversion mortgage for the second mortgage. - `InstrumentNumber` string — If the second mortgage is indexed by a recorder’s reference number, this will contain that number. Usually the year will not be added to this field unless there is a regional requirement. - `InterestChangeFreq` string — The frequency at which interest rates might change. - `InterestIndex` string — The benchmark interest rate the second mortgage’s rate is based on. - `InterestMargin` string — The fixed percentage rate added to an index value to determine the fully indexed interest rate of an adjustable rate mortgage for the second mortgage. - `InterestOnlyFlag` string — Specifies if the second mortgage has an interest only period. - `InterestOnlyPeriod` string — The length of the interest only period, in years. - `InterestRate` string — The interest rate of the second mortgage. - `InterestRateMax` string — The maximum interest rate allowed for the second mortgage, if it is an adjustable rate. - `InterestRateType` string — The interest rate type for the second mortgage. - `InterestTypeChangeDate` string — Specifies what date the loan will convert from a fixed interest rate to an adjustable interest rate in the format: `YY-MM-DD` (2-digit year, e.g. 2030 = “30”) - `InterestTypeInitial` string — The initial type of interest rate on the second mortgage. E.g. fixed or adjustable. - `IsLenderSeller` string — Specifies if the lender is also the seller for the second mortgage. - `LenderAddress` string — The address of the second mortgage lender. - `LenderCity` string — The city of the second mortgage lender. - `LenderCode` string — The standard ID code of the lender for the second mortgage. - `LenderFirstName` string — The first name of the second mortgage lender. This will be the complete name if the lender is a company. - `LenderFullName` string — The full standardized name of the lender for the second mortgage. - `LenderLastName` string — The last name of the second mortgage lender. - `LenderState` string — The state of the second mortgage lender. - `LenderType` string — The lender type for the second mortgage. - `LenderZip` string — The ZIP Code of the second mortgage lender. - `MaxInterestRateFirstChange` string — The maximum interest rate allowed when the loan is switched from a fixed to an adjustable interest rate. - `MinInterestRateFirstChange` string — The minimum interest rate allowed when the loan is switched from a fixed to an adjustable interest rate. - `Page` string — The second mortgage number page. This can contain either the recorder document page or the legal description page. - `PrepaymentPenaltyFlag` string — Specifies if the second mortgage has a pre-payment penalty. - `PrepaymentTerm` string — The number of months the second mortgage must remain active. - `RecordingDate` string — The second mortgage official filing date with the format: `YYYY-MM-DD`. This is normally located on the document. - `Term` string — The duration of the second mortgage. See the associated `TermType` to know the unit of measurement. - `TermDate` string — The due date of the second mortgage. - `TermType` string — The duration unit of measurement (month, year) for the second mortgage. See the associated `Term` to know the duration. - `Type` string — The type of loan for the second mortgage. E.g. conventional, construction, FHA, etc. - `Valuation` LookupDeedsValuation - `EstDownPayment` string — The estimated down payment made at the time of purchase. - `EstLTV` string — The estimated loan to value at the time of purchase. ## Other responses - `400` — Bad Request --- [API](https://skmtc.dev/melissa/apis/property.md) · [All operations](https://skmtc.dev/melissa/apis/property/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/melissa/property/revisions/20335d778b27/schema)