Skip to main content
GET
Read the financing, liens and valuation of a parcel (dated)
One parcel’s financing at the slice date, in four parts. The automated valuation carries the equity and the loan-to-value. Every open lien carries its lender, balance and rate. The mortgage history lists the mortgages recorded on the parcel over time. The fourth part lists the involuntary liens on record.

​
Use it when

The financing panel of a subject property: how much the owner owes, to whom, at what rate, and how much equity remains.

​
This block is dated

The financing, lien and valuation data is a snapshot valued at meta.coverage[].parcel.financing.as_of, not current data. BatchData’s current delivery does not carry the Recorder and Mortgage or the AVM dataset, so the slice is the last delivery that did. Every response from this route lists the blocks it carries in meta.dated[], with that date and the reason. data.dated is true while the snapshot holds. If you set require_current=true, the API does not serve the snapshot. It refuses the request with 422 dated_refused. When the datasets return to the order, this same route serves current data. Then dated goes false and the stamp disappears. Dated data explains this in full.

​
Read the response

  • summary is the whole picture in one block, and the search rows carry the same block. It holds the open lien count and balance, and the senior lien’s lender, rate and balance. It also says if a HELOC is open and if the parcel is free and clear, and it names the last recorded mortgage. open_lien_count: 0 is a measurement, not a null value.
  • open_liens[] lists the liens the owner still owes at the slice date, senior first (position: 1).
  • mortgage_history[] lists every mortgage the recorder shows, most recent first. It includes mortgages paid off long ago.
  • involuntary_liens[] lists UCC filings, judgements and tax liens. They are the only signal about foreclosure in this data. No delivery carries a notice of default, of sale or of lis pendens.
  • lender_class sorts a lender name into a bank, a mortgage company, a private party, a person or a government body. The API reads it from the name alone. Treat it as a classification, not as a fact from the document.
  • Every lender name carries the registry id beside it. The summary carries first_lien_lender_id and last_mortgage_lender_id. Each open lien and each history slot carries lender_id. The id is the key to the lender’s profile and its loans.
  • The id is null where the name stays. That occurs for a person-named lender below the person gate, for a placeholder row, and for a market with no lender registry.
  • valuation is the automated valuation with its range, confidence, equity and loan-to-value. It is null when the slice carries no valuation for the parcel. A null is not a value of zero.
  • Balances, rates and payments are the file’s estimates at the slice date, not statements from a servicer.

​
Gotchas

  • This host does not serve borrowers[] on a mortgage or parties[] on an involuntary lien. The records carry no such keys. Lender names are business names, and the host serves them.
  • The API answers 404 not_found when the parcel is in no loaded market or when the slice carries no row for it.
  • For a market with no published parcel tables, the API answers 422 parcels_unavailable. meta.coverage[].parcel.financing says in advance what the slice covers there.

Authorizations

​
Authorization
string
header
required

API key from the developer console (starts with zpka_). Create one at https://developers.investorlift.com/get-a-key.

Path Parameters

​
property_id
string
required

Parcel id, prop_<32 hex>, from /v1/properties/resolve or any deal's property.id. The prefix is part of the id (400 invalid_id otherwise).

Required string length: 1 - 64

Query Parameters

​
require_current
enum<string>

With true the API refuses the request with 422 dated_refused while the financing slice is a dated snapshot. With the default false the API serves the slice with meta.dated[].

Available options:
true,
false

Response

The financing, liens and valuation of one parcel, dated.

The financing, liens and valuation of one parcel, dated.

​
data
object
required

GET /v1/properties/{id}/financing: the parcel's valuation, open liens, mortgage history and involuntary liens at the slice date.

​
meta
object
required

Response metadata: when the API produced it, which markets it covers, and how fresh they are.