--- title: "Lookup deeds for a property" method: GET path: "/LookupDeeds" tags: ["Lookup Deeds"] --- # Lookup deeds for a property `GET /LookupDeeds` The LookupDeeds endpoint returns an array of deeds and/or transactions from the recorder table when given the Property MAK or the FIPs and APN. The service requires at least one of the following input combinations: **Set A** - `fips`, `apn` **Set B** - `mak` **Set C** - `ff` ## Query parameters - `cols` string - `format` 'json' | 'xml' - `id` unknown, required - `opt` string - `t` string - `apn` string - `fips` string - `ff` string, required - `mak` string - `txid` string ## Headers - `Accept` 'application/json' | 'application/xml' | '*/*', required - `Content-Type` 'application/json' | 'application/xml', required ## 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)